NetServerTransportAddEx 函式 (lmserver.h)

發行項
08/24/2023

NetServerTransportAddEx 函式會將指定的伺服器系結至傳輸通訊協定。此擴充函式可讓呼叫應用程式指定 SERVER_TRANSPORT_INFO_0、 SERVER_TRANSPORT_INFO_1、 SERVER_TRANSPORT_INFO_2或 SERVER_TRANSPORT_INFO_3 資訊層級。

語法

NET_API_STATUS NET_API_FUNCTION NetServerTransportAddEx(
  [in] LMSTR  servername,
  [in] DWORD  level,
  [in] LPBYTE bufptr
);

參數

[in] servername

字串的指標，指定要執行函式之遠端伺服器的名稱。如果此參數為 Null，則會使用本機電腦。

[in] level

指定值，指出資料的資訊層級。此參數可以是下列其中一個值。

值	意義
0	指定傳輸通訊協定的相關資訊，包括網路上的名稱、位址和位置。 bufptr參數指向SERVER_TRANSPORT_INFO_0結構。
1	指定傳輸通訊協定的相關資訊，包括名稱、位址、網路位置和網域。 bufptr參數會指向SERVER_TRANSPORT_INFO_1結構。
2	指定與層級 1 相同的資訊，並新增 svti2_flags 成員。 bufptr參數指向SERVER_TRANSPORT_INFO_2結構。
3	指定與層級 2 相同的資訊，並新增認證資訊。 bufptr參數指向SERVER_TRANSPORT_INFO_3結構。

[in] bufptr

包含資料的緩衝區指標。此資料的格式取決於 level 參數的值。

如需詳細資訊，請參閱網路管理功能緩衝區。

傳回值

如果函式成功，傳回值會NERR_Success。

如果函式失敗，傳回值可以是下列其中一個錯誤碼。

傳回碼	描述
ERROR_ACCESS_DENIED	使用者無法存取要求的資訊。
ERROR_DUP_NAME	網路上存在重複的名稱。
ERROR_INVALID_DOMAINNAME	在網路上找不到功能變數名稱。
ERROR_INVALID_LEVEL	為 level 參數指定的值無效。
ERROR_INVALID_PARAMETER	有一個參數無效。如果SERVER_TRANSPORT_INFO_0、SERVER_TRANSPORT_INFO_1、SERVER_TRANSPORT_INFO_2或bufptr參數所指向SERVER_TRANSPORT_INFO_3結構中的傳輸名稱或傳輸位址成員為 Null，就會傳回此錯誤。如果bufptr參數所指向的傳輸位址長度成員SERVER_TRANSPORT_INFO_0、SERVER_TRANSPORT_INFO_1、SERVER_TRANSPORT_INFO_2或SERVER_TRANSPORT_INFO_3結構為零或大於Windef.h標頭檔中定義的MAX_PATH () ，也會傳回此錯誤。如果bufptr參數所指向的旗標SERVER_TRANSPORT_INFO_2成員包含不合法的值SERVER_TRANSPORT_INFO_3，也會傳回此錯誤。其他無效參數也會傳回此錯誤。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足。

備註

只有 Administrators 或 Server Operators 本機群組的成員才能成功執行 NetServerTransportAddEx 函 式。

如果您使用 對 NetServerTransportAddEx 函式的呼叫，將傳輸通訊協定新增至伺服器，連線將不會在伺服器重新開機或重新開機之後保留。

NetServerComputerNameAdd函式是公用程式函式。它會結合 NetServerTransportEnum 函式和 NetServerTransportAddEx 函式的功能，可讓您指定模擬的伺服器名稱。

在 Windows Server 2008 和 Windows Vista service Pack 1 (SP1) 上，向 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 [僅限桌面應用程式]
目標平台	Windows
標頭	lmserver.h (包含 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll