Syntax

object.ViaListenInfo [= value]

Parts

object

Expression that evaluates to an object in the Applies To list

value

definition

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetViaListenInfo(LPBSTR);

HRESULT SetViaListenInfo(BSTR);

Note  SQL-DMO strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference by using SysFreeString.

Remarks

The ViaListenInfo property is comma delimited string in the form of:

nica:b,nicc:d

where a and c are nonnegative integers that specify the NIC number, and b and d specify the port on which the associated net card can listen. NIC values are zero or greater, and port numbers are in the range zero to MAX_DWORD.

The comma-delimited string is not a SQL-DMO multistring, and is stored as a REG_SZ in the Registry.

VIA is only compatible with the Windows NT® 4.0 and Windows® 2000 operating systems. For more information about VIA, see Communication Components.

Note  If an application calls ViaListenInfo on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000" are returned.

See Also