SERVER_TRANSPORT_INFO_2結構 (lmserver.h)
SERVER_TRANSPORT_INFO_2結構包含指定之傳輸通訊協定的相關資訊,包括傳輸名稱和位址。 此資訊層級僅適用于 NetServerTransportAddEx 函 式。
語法
typedef struct _SERVER_TRANSPORT_INFO_2 {
DWORD svti2_numberofvcs;
LMSTR svti2_transportname;
LPBYTE svti2_transportaddress;
DWORD svti2_transportaddresslength;
LMSTR svti2_networkaddress;
LMSTR svti2_domain;
ULONG svti2_flags;
} SERVER_TRANSPORT_INFO_2, *PSERVER_TRANSPORT_INFO_2, *LPSERVER_TRANSPORT_INFO_2;
成員
svti2_numberofvcs
類型: DWORD
連線到使用 svti2_transportname 成員所指定傳輸通訊協定之伺服器的用戶端數目。
svti2_transportname
類型: LMSTR
包含傳輸裝置名稱之 Null 終止字元字串的指標;例如,
\Device\NetBT_Tcpip_{2C9725F4-151A-11D3-AEEC-C3B211BD350B}
如果 已定義_WIN32_WINNT 或 FORCE_UNICODE ,則此字串為 Unicode。
svti2_transportaddress
類型: LPBYTE
包含伺服器所指定之傳輸裝置上所指定位址的變數指標 svti2_transportname 成員。
此成員通常是伺服器所使用的 NetBIOS 名稱。 在這些情況下,名稱長度必須為 16 個字元,最後一個字元必須是空白字元 (0x20) 。
svti2_transportaddresslength
類型: DWORD
svti2_transportaddress成員的長度,以位元組為單位。 對於 NetBIOS 名稱,此成員的值是 16 (十進位) 。
svti2_networkaddress
類型: LMSTR
包含網路介面卡所使用位址之 Null 終止字元字串的指標。 字串是傳輸特定的。
您只能使用 對 NetServerTransportEnum 函式的呼叫來擷取此值。 您無法使用 對 NetServerTransportAdd 函式或 NetServerTransportAddEx 函式的呼叫來設定此值。)
如果 已定義_WIN32_WINNT 或 FORCE_UNICODE ,則此字串為 Unicode。
svti2_domain
類型: LMSTR
Null 終止字元字串的指標,其中包含伺服器應該宣告其存在狀態的功能變數名稱。 (當您呼叫 NetServerTransportEnum時,此成員是伺服器宣告其目前狀態的功能變數名稱。)
如果 已定義_WIN32_WINNT 或 FORCE_UNICODE ,則此字串為 Unicode。
svti2_flags
類型: ULONG
這個成員可以是 Lmserver.h 標頭檔中定義的下列位值組合。
備註
NetServerTransportAddEx函式會使用SERVER_TRANSPORT_INFO_2結構,將指定的伺服器系結至傳輸通訊協定。
使用 SVTI2_REMAP_PIPE_NAMES 值的範例如下。 呼叫NetServerTransportAddEx函式以將傳輸新增至伺服器,並在svti2_transportaddress成員中指定 「MyServer」 的位址,並在svti2_flags成員中指定SVTI2_REMAP_PIPE_NAMES位址。 當用戶端嘗試在 「\MyServer」 上開啟 「Pipe」 時,用戶端實際上會改為開啟 $$MyServer\Pipe。
在 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) |