共用方式為


SERVER_TRANSPORT_INFO_3結構 (lmserver.h)

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_WINNTFORCE_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_WINNTFORCE_UNICODE ,則此字串為 Unicode。

svti3_domain

類型: LMSTR

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

如果 已定義_WIN32_WINNTFORCE_UNICODE ,則此字串為 Unicode。

svti3_flags

類型: ULONG

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

意義
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_passwordlengthsvti3_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_2SERVER_TRANSPORT_INFO_3結構的shi503_servername成員中指定。 NetShareDelEx函式是用來刪除範圍共用。 NetShareGetInfoNetShareSetInfo函式是用來取得和設定範圍共用的相關資訊。

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

需求

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

另請參閱

NetServerTransportAdd

NetServerTransportAddEx

NetServerTransportDel

NetServerTransportEnum

NetShareAdd

NetShareDelEx

NetShareGetInfo

NetShareSetInfo

網路管理概觀

網路管理結構

SERVER_TRANSPORT_INFO_0

SERVER_TRANSPORT_INFO_1

SERVER_TRANSPORT_INFO_2

SHARE_INFO_503

伺服器和工作站傳輸函式