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:
|
See Also
Reference
ViaRecognizedVendors Property
ViaVendor Property