次の方法で共有

RpcBindingToStringBindingA 関数 (rpcdce.h)

  • [アーティクル]

RpcBindingToStringBinding 関数は、バインド ハンドルの文字列表現を返します。

構文

RPC_STATUS RpcBindingToStringBindingA(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *StringBinding
);

パラメーター

Binding

バインド ハンドルの文字列表現に変換するクライアントまたはサーバー バインド ハンドル。

StringBinding

Binding パラメーターで指定されたバインド ハンドルの文字列表現へのポインターへのポインターを返します。

RpcBindingToStringBinding が StringBinding パラメーターを返さないようにするには、null 値を指定します。 この場合、アプリケーションは RpcStringFree 関数を呼び出しません。

戻り値

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

注釈

RpcBindingToStringBinding 関数は、クライアントまたはサーバーのバインド ハンドルを文字列表現に変換します。

RPC ランタイム ライブラリは、 StringBinding パラメーターで返される文字列にメモリを割り当てます。 アプリケーションは、 RpcStringFree 関数を呼び出してそのメモリの割り当てを解除する役割を担います。

Binding パラメーターのバインド ハンドルに nil オブジェクト UUID が含まれている場合、オブジェクト UUID フィールドは返される文字列に含まれません。

返された StringBinding パラメーターを 解析するには、 RpcStringBindingParse 関数を 呼び出します。

メモ クライアントのアドレスに対してクエリを実行するために、アプリケーションはまず RpcBindingServerFromClient 関数を呼び出して、部分的にバインドされたサーバー バインド ハンドルを取得します。 サーバー バインド ハンドルを使用すると、RpcBindingToStringBinding を呼び出して文字列バインディングを取得できます。 その後、サーバーは RpcStringBindingParse を呼び出して、文字列バインディングからクライアントのネットワーク アドレスを抽出できます。
 

注意

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

要件

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

こちらもご覧ください

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree