SERVER_TRANSPORT_INFO_3結構 (lmserver.h)

發行項
03/14/2023

SERVER_TRANSPORT_INFO_3結構包含指定傳輸通訊協定的相關資訊，包括名稱、位址和密碼 (認證) 。此資訊層級僅適用于 NetServerTransportAddEx 函式。

語法

typedef struct _SERVER_TRANSPORT_INFO_3 {
  DWORD  svti3_numberofvcs;
  LMSTR  svti3_transportname;
  LPBYTE svti3_transportaddress;
  DWORD  svti3_transportaddresslength;
  LMSTR  svti3_networkaddress;
  LMSTR  svti3_domain;
  ULONG  svti3_flags;
  DWORD  svti3_passwordlength;
  BYTE   svti3_password[256];
} SERVER_TRANSPORT_INFO_3, *PSERVER_TRANSPORT_INFO_3, *LPSERVER_TRANSPORT_INFO_3;

成員

svti3_numberofvcs

類型： DWORD

連線到使用 svti3_transportname 成員所指定傳輸通訊協定之伺服器的用戶端數目。

svti3_transportname

類型： LMSTR

包含傳輸裝置名稱之 Null 終止字元字串的指標;例如，

\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}

如果 已定義_WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。

svti3_transportaddress

類型： LPBYTE

包含伺服器所指定之傳輸裝置上之位址的變數指標 svti3_transportname 成員。

此成員通常是伺服器所使用的 NetBIOS 名稱。在這些情況下，名稱長度必須為 16 個字元，最後一個字元必須是空白字元 (0x20) 。

svti3_transportaddresslength

類型： DWORD

svti3_transportaddress成員的長度，以位元組為單位。對於 NetBIOS 名稱，此成員的值是 16 (十進位) 。

svti3_networkaddress

類型： LMSTR

包含網路介面卡所使用位址之 Null 終止字元字串的指標。字串是傳輸特定的。

您只能使用對 NetServerTransportEnum 函式的呼叫來擷取此值。您無法使用對 NetServerTransportAdd 函式或 NetServerTransportAddEx 函式的呼叫來設定此值。)

如果 已定義_WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。

svti3_domain

類型： LMSTR

Null 終止字元字串的指標，其中包含伺服器應該宣告其存在狀態的功能變數名稱。 (當您呼叫 NetServerTransportEnum時，此成員是伺服器宣告其目前狀態的功能變數名稱。)

如果 已定義_WIN32_WINNT 或 FORCE_UNICODE ，則此字串為 Unicode。

svti3_flags

類型： ULONG

這個成員可以是 Lmserver.h 標頭檔中定義的下列位值組合。

值	意義
SVTI2_REMAP_PIPE_NAMES	如果為端點設定這個值，則會重新路由傳送抵達傳輸以開啟具名管道的用戶端要求， (重新對應至下列本機管道名稱) ： $$\ServerName\PipeName 如需有關使用此值的詳細資訊，請參閱一節。
SVTI2_SCOPED_NAME	如果為端點設定這個值，而且嘗試使用相同的網路位址建立第二個傳輸，但 SCOPED 旗標有不同的傳輸名稱和衝突設定，此傳輸建立將會失敗。因此，指定網路位址的每個已註冊傳輸都必須具有相同的範圍設定。如需有關使用此值的詳細資訊，請參閱一節。此值定義于 Windows Server 2008 和 Windows Vista SP1 上。

值

意義

SVTI2_REMAP_PIPE_NAMES

如果為端點設定這個值，則會重新路由傳送抵達傳輸以開啟具名管道的用戶端要求， (重新對應至下列本機管道名稱) ：

$$\ServerName\PipeName

如需有關使用此值的詳細資訊，請參閱一節。

SVTI2_SCOPED_NAME

如果為端點設定這個值，而且嘗試使用相同的網路位址建立第二個傳輸，但 SCOPED 旗標有不同的傳輸名稱和衝突設定，此傳輸建立將會失敗。因此，指定網路位址的每個已註冊傳輸都必須具有相同的範圍設定。

如需有關使用此值的詳細資訊，請參閱一節。

此值定義于 Windows Server 2008 和 Windows Vista SP1 上。

svti3_passwordlength

類型： DWORD

svti3_password成員中的有效位元組數目。

svti3_password[256]

類型： BYTE[256]

要用於新傳輸位址的認證。如果 svti3_passwordlength 成員為零，則會使用伺服器的認證。

備註

NetServerTransportAddEx函式會使用SERVER_TRANSPORT_INFO_3結構，將指定的伺服器系結至傳輸通訊協定。

使用 SVTI2_REMAP_PIPE_NAMES 值的範例如下。呼叫 NetServerTransportAddEx 函式以將傳輸新增至伺服器，並在 svti3_transportaddress 成員中指定「MyServer」的位址，並在 svti3_flags 成員中指定 SVTI2_REMAP_PIPE_NAMES 。當用戶端嘗試在「\MyServer」上開啟「Pipe」時，用戶端實際上會改為開啟 $$MyServer\Pipe。

用戶端和伺服器必須 有svti3_passwordlength 和 svti3_password 成員才能執行相互驗證。

在 Windows Server 2008 和具有 SP1 的 Windows Vista 上，向 Windows 遠端檔案伺服器註冊的每個名稱 (SRV) 都會指定為範圍名稱或非範圍名稱。接著，新增至系統的每個共用都會附加至所有非範圍名稱，或附加至單一範圍名稱。想要使用範圍功能的應用程式負責將新名稱註冊為限定範圍的端點，然後建立具有適當範圍的共用。如此一來，舊版網路管理和網路共用管理功能的使用不會以任何方式受到影響，因為它們會繼續將共用和名稱註冊為非範圍的名稱。

範圍端點的建立方式是呼叫NetServerTransportAddEx函式，並將level參數設定為 2，而 bufptr參數指向SERVER_TRANSPORT_INFO_2結構，並在svti2_flags成員中設定SVTI2_SCOPED_NAME位值。範圍端點也會藉由呼叫NetServerTransportAddEx函式，並將level參數設定為 3，而 bufptr參數指向SERVER_TRANSPORT_INFO_3結構，並在svti3_flags成員中設定SVTI2_SCOPED_NAME位值。

當為傳輸設定SVTI2_SCOPED_NAME位值時，可以使用對應的伺服器名稱來新增共用， (使用NetShareAdd函式) 範圍方式) SHARE_INFO_503結構shi503_servername成員。如果沒有使用 SVTI2_SCOPED_NAME 位值註冊的傳輸，而且 shi503_servername 成員中提供的名稱，則共用會以範圍方式新增將不會成功。

NetShareAdd函式可用來在servername參數中指定的遠端伺服器上新增範圍共用。 在 bufptr參數中傳遞之SHARE_INFO_503shi503_servername成員中指定的遠端伺服器，必須使用NetServerTransportAddEx函式作為範圍端點系結至傳輸通訊協定。 SVTI2_SCOPED_NAME旗標必須已在傳輸通訊協定SERVER_TRANSPORT_INFO_2或SERVER_TRANSPORT_INFO_3結構的shi503_servername成員中指定。 NetShareDelEx函式是用來刪除範圍共用。 NetShareGetInfo和NetShareSetInfo函式是用來取得和設定範圍共用的相關資訊。

叢集命名空間通常會使用限定範圍的端點。

需求


最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	lmserver.h (包含 Lm.h)