• Article

ViaListenInfo Property

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité.

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

Syntaxe

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);

Notes

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.

Notes

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

Notes

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.

Notes

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