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 ランタイム関数ライブラリは、この関数の呼び出しごとに Binding と Annotation にメモリを割り当てます。 返される各 Binding に対して RpcBindingFree を呼び出し、返された Annotation ごとに RpcStringFree を呼び出す必要があります。

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

注意

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

要件

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

こちらもご覧ください

RpcEpRegister

RpcMgmtEpEltInqBegin

RpcMgmtEpEltInqDone