次の方法で共有

RpcMgmtEpEltInqNext 関数 (rpcdce.h)

  • [アーティクル]

RpcMgmtEpEltInqNext 関数は、エンドポイント マップから 1 つの要素を返します。

構文

RPC_STATUS RpcMgmtEpEltInqNext(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  RPC_CSTR           *Annotation
);

パラメーター

InquiryContext

照会コンテキストを指定します。 照会コンテキストは、 RpcMgmtEpEltInqBegin から返されます。

IfId

endpoint-map 要素のインターフェイス識別子を返します。

Binding

省略可能。 endpoint-map 要素からバインド ハンドルを返します。

Annotation

省略可能。 endpoint-map 要素の注釈文字列を返します。 endpoint-map 要素に注釈文字列がない場合は、空の文字列 ("") が返されます。

戻り値

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

注釈

RpcMgmtEpEltInqNext 関数は、エンドポイント マップから 1 つの要素を返します。 選択された要素は、照会コンテキストによって異なります。 選択基準は、 InquiryContext を返した RpcMgmtEpEltInqBegin 関数 の InquiryType によって決定されます。

アプリケーションは、 RpcMgmtEpEltInqNext を繰り返し呼び出すことによって、選択したすべてのエンドポイント マップ要素を表示できます。 すべての要素が表示されると、この関数はRPC_X_NO_MORE_ENTRIES状態を返します。 返される要素は順序付けされません。

それぞれの引数が NULL 以外の場合、RPC ランタイム関数ライブラリは、この関数の呼び出しごとに Binding と Annotation にメモリを割り当てます。 返される各 Binding に対して RpcBindingFree を呼び出し、返される各 Annotation に対して RpcStringFree を呼び出す必要があります。

エンドポイント マップ要素を表示した後、アプリケーションは RpcMgmtEpEltInqDone を呼び出して照会コンテキストを削除する必要があります。

要件

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

こちらもご覧ください

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone