次の方法で共有

RpcBindingFromStringBindingW 関数 (rpcdce.h)

  • [アーティクル]

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

構文

RPC_STATUS RpcBindingFromStringBindingW(
  RPC_WSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

パラメーター

StringBinding

バインド ハンドルの文字列表現へのポインター。

Binding

サーバー バインド ハンドルへのポインターを返します。

戻り値

値 説明
RPC_S_OK
 呼び出しは成功しました。
RPC_S_INVALID_STRING_BINDING
 文字列バインディングが無効です。
RPC_S_PROTSEQ_NOT_SUPPORTED
 プロトコル シーケンスは、このホストではサポートされていません。
RPC_S_INVALID_RPC_PROTSEQ
 プロトコル シーケンスが無効です。
RPC_S_INVALID_ENDPOINT_FORMAT
 エンドポイントの形式が無効です。
RPC_S_STRING_TOO_LONG
 文字列が長すぎます。
RPC_S_INVALID_NET_ADDR
 ネットワーク アドレスが無効です。
RPC_S_INVALID_ARG
 引数が無効です。
RPC_S_INVALID_NAF_ID
 ネットワーク アドレス ファミリ識別子が無効です。
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

解説

RpcBindingFromStringBinding 関数は、バインド ハンドルの文字列表現からサーバー バインド ハンドルを作成します。 StringBinding パラメーターには、オブジェクト UUID を含める必要はありません。 この場合、返されるバインディングには nil UUID が含まれます。 指定された StringBinding パラメーターに エンドポイント フィールドが含まれていない場合、返される Binding パラメーターは部分的にバインドされたバインド ハンドルです。 指定された StringBinding パラメーターに エンドポイント フィールドが含まれている場合、エンドポイントは既知のエンドポイントと見なされます。 指定された StringBinding パラメーターに ホスト アドレス フィールドが含まれていない場合、返される Binding パラメーターはローカル ホストを参照します。

アプリケーションは、 RpcStringBindingCompose 関数を呼び出すか、文字列定数を指定して文字列バインディングを作成します。 このメソッドによる文字列バインディングの作成には、サーバーとの接続は含まれません。 API の成功または失敗は、サーバーの可用性を示すものではありません。

Binding パラメーターを使用してアプリケーションが終了したら、アプリケーションは RpcBindingFree 関数を呼び出して、バインド ハンドルで使用されるメモリを解放する必要があります。

注意

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

要件

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

関連項目

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose