ViaListenInfo Property

后续版本的 Microsoft SQL Server 将删除该功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。

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

语法

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

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.

注释

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

VIA is only compatible with the Microsoft operating systems.

注意注意

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: