共用方式為


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 函式,以指示伺服器停止接聽遠端程序呼叫。 如果 DontWaitTRUE,應用程式應該呼叫 RpcMgmtWaitServerListen 以等候所有呼叫完成。

當它收到停止接聽要求時,RPC 執行時間程式庫會停止接受所有已註冊介面的新遠端程序呼叫。 允許執行呼叫完成,包括回呼。 完成所有呼叫之後,此函式會發出 RpcServerListen 函式的訊號,指出它必須停止接聽並返回呼叫端。 如果RpcServerListenDontWait參數設定為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