次の方法で共有

RpcMgmtEpEltInqNextW 関数 (rpcdce.h)

  • [アーティクル]

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

構文

RPC_STATUS RpcMgmtEpEltInqNextW(
  RPC_EP_INQ_HANDLE  InquiryContext,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE *Binding,
  UUID               *ObjectUuid,
  RPC_WSTR           *Annotation
);

パラメーター

InquiryContext

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

IfId

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

Binding

随意。 endpoint-map 要素からバインド ハンドルを返します。

ObjectUuid

随意。 endpoint-map 要素からオブジェクト UUID を返します。

Annotation

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

戻り値

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

備考

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

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

それぞれの引数が NULL 以外の場合、RPC ランタイム関数ライブラリは、この関数を呼び出すたびに、バインド と 注釈 にメモリを割り当てます。 アプリケーションは、返された各 バインド に対 RpcBindingFree を呼び出し、返された各 Annotationに対して RpcStringFree を します。

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

手記

rpcdce.h ヘッダーは、RPCMgmtEpEltInqNext を、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー rpcdce.h (Rpc.h を含む)
ライブラリ Rpcrt4.lib
DLL Rpcrt4.dll

関連項目

RpcEpRegister の

RpcMgmtEpEltInqBegin を する

RpcMgmtEpEltInqDone の