NetServerTransportDel 函式 (lmserver.h)
NetServerTransportDel函式會解除系結 (或中斷連線,) 伺服器的傳輸通訊協定。 實際上,伺服器無法再使用指定的傳輸通訊協定 (來與用戶端通訊,例如 TCP 或 XNS) 。
語法
NET_API_STATUS NET_API_FUNCTION NetServerTransportDel(
[in] LMSTR servername,
[in] DWORD level,
[in] LPBYTE bufptr
);
參數
[in] servername
字串的指標,指定要在其中執行函式之遠端伺服器的 DNS 或 NetBIOS 名稱。 如果此參數為 Null,則會使用本機電腦。
[in] level
指定資料的資訊層級。 此參數可以是下列其中一個值。
值 | 意義 |
---|---|
|
指定傳輸通訊協定的相關資訊,包括網路上的名稱、位址和位置。 bufptr參數指向SERVER_TRANSPORT_INFO_0結構。 |
|
指定傳輸通訊協定的相關資訊,包括名稱、位址、網路位置和網域。 bufptr參數會指向SERVER_TRANSPORT_INFO_1結構。 |
[in] bufptr
指定資料的緩衝區指標。 此資料的格式取決於 level 參數的值。 如需詳細資訊,請參閱 網路管理功能緩衝區。
傳回值
如果函式成功,傳回值會NERR_Success。
如果函式失敗,傳回值可以是下列其中一個錯誤碼。
傳回碼 | 描述 |
---|---|
|
使用者無法存取要求的資訊。 |
|
為 level 參數指定的值無效。 |
|
指定的參數無效。 |
|
記憶體不足。 |
|
共用名稱不存在。 |
備註
只有 Administrators 或 Server Operators 本機群組的成員可以成功執行 NetServerTransportDel 函式。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | lmserver.h (包含 Lm.h) |
程式庫 | Netapi32.lib |
Dll | Netapi32.dll |