RpcBindingCreateW 関数 (rpcdce.h)

  • [アーティクル]

RpcBindingCreate 関数は、指定されたテンプレートに基づいて、新しい高速 RPC バインド ハンドルを作成します。

構文

RPC_STATUS RpcBindingCreateW(
  [in]           RPC_BINDING_HANDLE_TEMPLATE_V1_W *Template,
  [in, optional] RPC_BINDING_HANDLE_SECURITY_V1_W *Security,
  [in, optional] RPC_BINDING_HANDLE_OPTIONS_V1    *Options,
  [out]          RPC_BINDING_HANDLE               *Binding
);

パラメーター

[in] Template

RPC_BINDING_HANDLE_TEMPLATE この呼び出しによって作成されるバインディング ハンドルを記述する構造体です。 このデータは呼び出し中に上書きされる可能性があるため、API はこのデータへの参照を保持しません。 呼び出し元は、API が返されるときに、この構造体で使用されるメモリを解放する必要があります。

[in, optional] Security

RPC_BINDING_HANDLE_SECURITY このバインディング ハンドルのセキュリティ オプションを記述する構造体です。 このデータは呼び出し中に上書きされる可能性があるため、API はこのデータへの参照を保持しません。 呼び出し元は、API が返されるときに、この構造体で使用されるメモリを解放する必要があります。

このパラメーターは省略可能です。 このパラメーターが NULL に設定されている場合は、 RPC_BINDING_HANDLE_SECURITY の既定のセキュリティ設定が使用されます。

[in, optional] Options

RPC_BINDING_HANDLE_OPTIONS バインディング ハンドルの追加オプションを記述する構造体です。 このデータは呼び出し中に上書きされる可能性があるため、API はこのデータへの参照を保持しません。 呼び出し元は、API が返されるときに、この構造体で使用されるメモリを解放する必要があります。

このパラメーターは省略可能です。 このパラメーターが NULL に設定されている場合は、 RPC_BINDING_HANDLE_OPTIONS の既定のオプションが使用されます。

[out] Binding

RPC_BINDING_HANDLE 新しく作成されたバインド ハンドルを含む構造体です。 この関数がRPC_S_OKを返さなかった場合、この構造体の内容は未定義です。 ローカル以外の RPC 呼び出しの場合は、このハンドルを RpcBindingBind に渡す必要があります。

戻り値

この関数は、成功したRPC_S_OKを返します。それ以外の場合は、RPC_S_* エラー コードが返されます。 これらのエラー コードの詳細については、「 RPC 戻り値」を参照してください。

リターン コード 説明
RPC_S_OK
 バインド ハンドルが正常に作成されました。
RPC_S_CANNOT_SUPPORT
 このバインド ハンドルに対して RPC の古い機能が要求されました。
メモ この API でサポートされているプロトコル シーケンスは ncalrpc のみです。別のプロトコル シーケンスを選択すると、このエラー状態コードが返されます。
 
 
メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。
 

解説

この API によって返される RPC バインド ハンドルは、バインド ハンドルをパラメーターとして受け入れる他の関数と共に使用できます。

ただし、バインド ハンドルで呼び出しを行う前に、リモート呼び出しでバインド ハンドルを使用できるようにするには、 RpcBindingBind を呼び出す必要があります。 RpcBindingCreate API は、ネットワークに触れたり、RPC サーバーとの通信を試みるのではなく、テンプレートで指定された値に基づいて内部データ構造を構築するだけです。 正常な戻り値は、RPC サーバーが使用可能、アクセス可能、または正しく指定されていることを示すものではありません。

注意

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

要件

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

関連項目

RPC_BINDING_HANDLE

RpcBindingBind