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 は既定で無効になっています。 この関数を有効にするには、RpcMgmtStopServerListening が呼び出されるたびに TRUE (リモート シャットダウンを許可する) 返す承認関数をサーバー アプリケーションに作成します。 RpcMgmtSetAuthorizationFn を使用して、クライアントに管理機能へのアクセス権を付与します。
 
この関数を成功させるには、サーバーがリモート プロシージャ呼び出しをリッスンしている必要があります。 サーバーがリッスンしていない場合、関数は失敗します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー rpcdce.h (Rpc.h を含む)
Library Rpcrt4.lib
[DLL] Rpcrt4.dll

関連項目

RpcEpResolveBinding

RpcMgmtWaitServerListen

RpcServerListen

RpcServerRegisterIfEx