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 要素に注釈文字列がない場合は、空の文字列 ("") が返されます。
戻り値
値 | 意味 |
---|---|
|
呼び出しは成功しました。 |
注釈
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 |