次の方法で共有

RpcBindingToStringBindingW 関数 (rpcdce.h)

  • [アーティクル]

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

構文

RPC_STATUS RpcBindingToStringBindingW(
  RPC_BINDING_HANDLE Binding,
  RPC_WSTR           *StringBinding
);

パラメーター

Binding

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

StringBinding

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

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

戻り値

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

備考

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

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

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

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

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

手記

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

必要条件

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

関連項目

RpcBindingFromStringBinding

RpcStringBindingParse の

RpcStringFree を する