NetServerTransportAdd 函式 (lmserver.h)
NetServerTransportAdd 函式會將伺服器系結至傳輸通訊協定。
擴充函式 NetServerTransportAddEx 可讓呼叫應用程式指定 SERVER_TRANSPORT_INFO_1、 SERVER_TRANSPORT_INFO_2和 SERVER_TRANSPORT_INFO_3 資訊層級。
語法
NET_API_STATUS NET_API_FUNCTION NetServerTransportAdd(
[in] LMSTR servername,
[in] DWORD level,
[in] LPBYTE bufptr
);
參數
[in] servername
字串的指標，指定要執行函式之遠端伺服器的名稱。 如果此參數為 NULL，則會使用本機電腦。
[in] level
指定資料的資訊層級。 此參數可以是下列值。
| 值 | 意義 |
|---|---|
|
指定傳輸通訊協議的相關信息，包括網路上的名稱、位址和位置。 bufptr 參數指向SERVER_TRANSPORT_INFO_0結構。 |
[in] bufptr
包含數據的緩衝區指標。
如需詳細資訊，請參閱 網路管理功能緩衝區。
傳回值
如果函式成功，傳回值會NERR_Success。
如果函式失敗，傳回值可以是下列其中一個錯誤碼。
| 傳回碼 | Description |
|---|---|
|
用戶無法存取要求的資訊。 |
|
網路上存在重複的名稱。 |
|
在網路上找不到功能變數名稱。 |
|
為 level 參數指定的值無效。 |
|
有一個參數無效。
如果 bufptr 參數所指向SERVER_TRANSPORT_INFO_0結構中的svti0_transportname或svti0_transportaddress成員為 NULL，就會傳回此錯誤。 如果bufptr參數所指向SERVER_TRANSPORT_INFO_0結構中的svti0_transportaddresslength成員是零或大於 Windef.h 頭檔中定義的MAX_PATH (，也會傳回此錯誤) 。 其他無效參數也會傳回此錯誤。 |
|
記憶體不足。 |
備註
只有 Administrators 或 Server Operators 本地組的成員才能成功執行 NetServerTransportAdd 函式 。
如果您使用 對 NetServerTransportAdd 函式的呼叫，將傳輸通訊協定新增至伺服器，則伺服器重新啟動或重新啟動之後，將不會保留連線。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | lmserver.h (包含 Lm.h) |
| 程式庫 | Netapi32.lib |
| Dll | Netapi32.dll |