RpcMgmtStopServerListening 函式 (rpcdce.h)
RpcMgmtStopServerListening函式會告訴伺服器停止接聽遠端程序呼叫。 此函式不會影響自動接聽介面。 如需詳細資訊,請參閱 RpcServerRegisterIfEx 。
語法
RPC_STATUS RpcMgmtStopServerListening(
RPC_BINDING_HANDLE Binding
);
參數
Binding
若要指示遠端應用程式停止接聽遠端程序呼叫,請指定該應用程式的伺服器系結控制碼。 若要指示您自己的 (本機) 應用程式停止接聽遠端程序呼叫,請指定 Null的值。
傳回值
值 | 意義 |
---|---|
|
呼叫成功。 |
|
系結控制碼無效。 |
|
這是作業的系結錯誤種類。 |
注意 如需有效錯誤碼的清單,請參閱 RPC 傳回值。
備註
應用程式會呼叫 RpcMgmtStopServerListening 函式,以指示伺服器停止接聽遠端程序呼叫。 如果 DontWait 為 TRUE,應用程式應該呼叫 RpcMgmtWaitServerListen 以等候所有呼叫完成。
當它收到停止接聽要求時,RPC 執行時間程式庫會停止接受所有已註冊介面的新遠端程序呼叫。 允許執行呼叫完成,包括回呼。 完成所有呼叫之後,此函式會發出 RpcServerListen 函式的訊號,指出它必須停止接聽並返回呼叫端。 如果RpcServerListen的DontWait參數設定為TRUE,則應用程式會呼叫RpcMgmtWaitServerListen,讓所有剩餘的呼叫都完成。
注意 根據預設,從用戶端停用 RpcMgmtStopServerListening 。 若要啟用此函式,請在伺服器應用程式中建立授權函式,以傳回 TRUE (,以便在呼叫 RpcMgmtStopServerListening 時允許遠端關機) 。 使用 RpcMgmtSetAuthorizationFn 提供用戶端對管理功能的存取權。
需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | rpcdce.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |