RpcBindingToStringBinding 関数 (rpcdce.h)
RpcBindingToStringBinding 関数は、バインド ハンドルの文字列表現を返します。
構文
RPC_STATUS RpcBindingToStringBinding(
RPC_BINDING_HANDLE Binding,
RPC_CSTR *StringBinding
);
パラメーター
Binding
バインド ハンドルの文字列表現に変換するクライアントまたはサーバー バインド ハンドル。
StringBinding
Binding パラメーターで指定されたバインド ハンドルの文字列表現へのポインターへのポインターを返します。
RpcBindingToStringBinding が StringBinding パラメーターを返さないようにするには、null 値を指定します。 この場合、アプリケーションは RpcStringFree 関数を呼び出しません。
戻り値
| 値 | 意味 |
|---|---|
|
呼び出しは成功しました。 |
|
バインド ハンドルが無効です。 |
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
注釈
RpcBindingToStringBinding 関数は、クライアントまたはサーバーのバインド ハンドルを文字列表現に変換します。
RPC ランタイム ライブラリは、 StringBinding パラメーターで返される文字列にメモリを割り当てます。 アプリケーションは、 RpcStringFree 関数を呼び出してそのメモリの割り当てを解除する役割を担います。
Binding パラメーターのバインド ハンドルに nil オブジェクト UUID が含まれている場合、オブジェクト UUID フィールドは返される文字列に含まれません。
返された StringBinding パラメーターを 解析するには、 RpcStringBindingParse 関数を 呼び出します。
メモ クライアントのアドレスに対してクエリを実行するために、アプリケーションはまず RpcBindingServerFromClient 関数を呼び出して、部分的にバインドされたサーバー バインド ハンドルを取得します。 サーバー バインド ハンドルを使用して、RpcBindingToStringBinding を呼び出して文字列バインディングを取得できます。 その後、サーバーは RpcStringBindingParse を呼び出して、文字列バインディングからクライアントのネットワーク アドレスを抽出できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | rpcdce.h (Rpc.h を含む) |
| Library | Rpcrt4.lib |
| [DLL] | Rpcrt4.dll |