RpcMgmtEpEltInqBegin 関数 (rpcdce.h)

  • [アーティクル]

RpcMgmtEpEltInqBegin 関数は、エンドポイント マップ内の要素を表示するための照会コンテキストを作成します。

構文

RPC_STATUS RpcMgmtEpEltInqBegin(
  RPC_BINDING_HANDLE EpBinding,
  unsigned long      InquiryType,
  RPC_IF_ID          *IfId,
  unsigned long      VersOption,
  UUID               *ObjectUuid,
  RPC_EP_INQ_HANDLE  *InquiryContext
);

パラメーター

EpBinding

エンドポイント マップ要素を表示するホストへのバインド ハンドル。 ローカル ホストの要素を表示するには 、NULL を 指定します。 バインド ハンドルを指定する場合、バインド ハンドルのオブジェクト UUID は NULL である必要があります。 存在する場合、バインド ハンドル上のエンドポイントは無視され、指定されたホスト上のエンドポイント マッパー データベースへのエンドポイントが使用されます。

InquiryType

エンドポイント マップで実行する照会の種類を示す整数値。 有効な照会の種類を次に示します。

値 意味
RPC_C_EP_ALL_ELTS
 エンドポイント マップからすべての要素を返します。 IfId、VersOption、および ObjectUuid パラメーターは無視されます。
RPC_C_EP_MATCH_BY_IF
 IfId 値と VersOption 値で指定されたインターフェイス識別子を含む要素をエンドポイント マップで検索します。
RPC_C_EP_MATCH_BY_OBJ
 ObjectUuid で指定されたオブジェクト UUID を含む要素をエンドポイント マップで検索します。
RPC_C_EP_MATCH_BY_BOTH
 IfId、VersOption、ObjectUuid で指定されたインターフェイス識別子とオブジェクト UUID を含む要素をエンドポイント マップで検索します。

IfId

RpcMgmtEpEltInqNext によって返されるエンドポイント マップ要素のインターフェイス識別子。 このパラメーターは、 InquiryType がRPC_C_EP_MATCH_BY_IFまたはRPC_C_EP_MATCH_BY_BOTHの場合にのみ使用されます。 それ以外の場合は無視されます。

VersOption

RpcMgmtEpEltInqNext で IfId パラメーターを使用する方法を指定します。 このパラメーターは、 InquiryType がRPC_C_EP_MATCH_BY_IFまたはRPC_C_EP_MATCH_BY_BOTHの場合にのみ使用されます。 それ以外の場合は無視されます。 このパラメーターの有効な値を次に示します。

値 意味
RPC_C_VERS_ALL
 バージョン番号に関係なく、指定されたインターフェイス UUID を提供するエンドポイント マップ要素を返します。
RPC_C_VERS_COMPATIBLE
 指定したインターフェイス UUID のメジャー バージョンと、指定したインターフェイス UUID のマイナー バージョン以上のマイナー バージョンを提供するエンドポイント マップ要素を返します。
RPC_C_VERS_EXACT
 指定したインターフェイス UUID の指定したバージョンを提供するエンドポイント マップ要素を返します。
RPC_C_VERS_MAJOR_ONLY
 指定したインターフェイス UUID と同じメジャー バージョンを提供し、マイナー バージョンを無視するエンドポイント マップ要素を返します。
RPC_C_VERS_UPTO
 指定したメジャー バージョンとマイナー バージョン以下の、指定したインターフェイス UUID のバージョンを提供するエンドポイント マップ要素を返します。

ObjectUuid

RpcMgmtEpEltInqNext がエンドポイント マップ要素で検索するオブジェクト UUID。 このパラメーターは、 InquiryType がRPC_C_EP_MATCH_BY_OBJまたはRPC_C_EP_MATCH_BY_BOTHの場合にのみ使用されます。

InquiryContext

RpcMgmtEpEltInqNext および RpcMgmtEpEltInqDone で使用するための照会コンテキストを返します。 「RPC_EP_INQ_HANDLE」を参照してください。

戻り値

値 意味
RPC_S_OK
 呼び出しは成功しました。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

注釈

RpcMgmtEpEltInqBegin 関数は、エンドポイント マップに格納されているサーバー アドレス情報を表示するための照会コンテキストを作成します。 アプリケーションは、InquiryType と VersOption を使用して、RpcMgmtEpEltInqNext の呼び出しから返される次のエンドポイント マップ要素を指定します。

  • すべての要素
  • 指定されたインターフェイス識別子を持つ要素
  • 指定されたオブジェクト UUID を持つ要素
  • 指定されたインターフェイス識別子とオブジェクト UUID の両方を持つ要素
RpcMgmtEpEltInqNext を呼び出す前に、アプリケーションは最初にこの関数を呼び出して照会コンテキストを作成する必要があります。 エンドポイント マップ要素を表示した後、アプリケーションは RpcMgmtEpEltInqDone を呼び出して、照会コンテキストを削除します。

要件

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

こちらもご覧ください

RpcEpRegister

RpcMgmtEpEltInqDone

RpcMgmtEpEltInqNext