RpcMgmtStopServerListening 函式 (rpcdce.h)

RpcMgmtStopServerListening函式會告訴伺服器停止接聽遠端程序呼叫。 此函式不會影響自動接聽介面。 如需詳細資訊，請參閱 RpcServerRegisterIfEx 。

語法

RPC_STATUS RpcMgmtStopServerListening(
  RPC_BINDING_HANDLE Binding
);

參數

Binding

若要指示遠端應用程式停止接聽遠端程序呼叫，請指定該應用程式的伺服器系結控制碼。 若要指示您自己的 (本機) 應用程式停止接聽遠端程序呼叫，請指定 Null的值。

傳回值

值	意義
RPC_S_OK	呼叫成功。
RPC_S_INVALID_BINDING	系結控制碼無效。
RPC_S_WRONG_KIND_OF_BINDING	這是作業的系結錯誤種類。

 

注意 如需有效錯誤碼的清單，請參閱 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

另請參閱

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx