NetServerTransportAdd 函式 (lmserver.h)

NetServerTransportAdd 函式會將伺服器系結至傳輸通訊協定。

語法

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

[in] servername

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

[in] level

指定資料的資訊層級。此參數可以是下列值。

值	意義
0	指定傳輸通訊協議的相關信息，包括網路上的名稱、位址和位置。 bufptr 參數指向SERVER_TRANSPORT_INFO_0結構。

[in] bufptr

包含數據的緩衝區指標。

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

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

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

傳回碼	Description
ERROR_ACCESS_DENIED	用戶無法存取要求的資訊。
ERROR_DUP_NAME	網路上存在重複的名稱。
ERROR_INVALID_DOMAINNAME	在網路上找不到功能變數名稱。
ERROR_INVALID_LEVEL	為 level 參數指定的值無效。
ERROR_INVALID_PARAMETER	有一個參數無效。如果 bufptr 參數所指向SERVER_TRANSPORT_INFO_0結構中的svti0_transportname或svti0_transportaddress成員為 NULL，就會傳回此錯誤。如果bufptr參數所指向SERVER_TRANSPORT_INFO_0結構中的svti0_transportaddresslength成員是零或大於 Windef.h 頭檔中定義的MAX_PATH (，也會傳回此錯誤) 。其他無效參數也會傳回此錯誤。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足。

只有 Administrators 或 Server Operators 本地組的成員才能成功執行 NetServerTransportAdd 函式 。

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

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	lmserver.h (包含 Lm.h)
程式庫	Netapi32.lib
Dll	Netapi32.dll