• Article

ViaListenInfo Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The ViaListenInfo property specifies the network interface card (NIC) and port number when using Virtual Interface Architecture (VIA) protocol.

Syntax

object.ViaListenInfo [= value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list

  • value
    A definition

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetViaListenInfo(LPBSTR);
HRESULT SetViaListenInfo(BSTR);

Note

SQL Distributed Management Objects (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:

Note

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 it is stored as a REG_SZ in the registry.

VIA is only compatible with the Microsoft operating systems.

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 or later" are returned.

Applies To:

Registry2 Object