RpcMgmtIsServerListening 関数 (rpcdce.h)

  • [アーティクル]

RpcMgmtIsServerListening 関数は、サーバーがリモート プロシージャ 呼び出しをリッスンしているかどうかを示します。

構文

RPC_STATUS RpcMgmtIsServerListening(
  RPC_BINDING_HANDLE Binding
);

パラメーター

Binding

リモート アプリケーションがリモート プロシージャ コールをリッスンしているかどうかを確認するには、そのアプリケーションのサーバー バインド ハンドルを指定します。 独自の (ローカル) アプリケーションがリモート プロシージャ 呼び出しをリッスンしているかどうかを判断するには、 値 NULL を指定します。

戻り値

値 意味
RPC_S_OK
 リモート プロシージャ コールをリッスンしているサーバー。
RPC_S_NOT_LISTENING
 サーバーがリモート プロシージャ 呼び出しをリッスンしていないか、インターフェイスが自動リッスンしています。
RPC_S_INVALID_BINDING
 バインド ハンドルが無効です。
RPC_S_WRONG_KIND_OF_BINDING
 これは、操作のバインドの種類が間違っていました。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 
 

RpcMgmtIsServerListening 関数は、自動リッスンしていないインターフェイスに対してのみ正しい結果を返します。 サーバー アプリケーションが自動リッスンしていて 、RpcMgmtIsServerListening 関数を 呼び出すと、 RpcMgmtIsServerListening はRPC_SERVER_NOT_LISTENINGを返しますが、サーバーがリッスンしている可能性があり、以降の RPC 呼び出しは成功する可能性があります。

注釈

アプリケーションは RpcMgmtIsServerListening 関数を 呼び出して、 Binding パラメーターで指定されたサーバーがリモート プロシージャ 呼び出しをリッスンしているかどうかを判断します。

サーバーが RpcServerListen を呼び出した場合、 RpcMgmtIsServerListening 関数は RPC_S_OK の値 を返します。

この関数を成功させるには、サーバーがリモート プロシージャ呼び出しをリッスンしている必要があります。 サーバーがリッスンしていない場合、関数は失敗します。

要件

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

こちらもご覧ください

RpcEpResolveBinding

RpcServerListen