RpcBindingCreateA 関数 (rpcdce.h)

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

構文

RPC_STATUS RpcBindingCreateA(
  [in]           RPC_BINDING_HANDLE_TEMPLATE_V1_A *Template,
  [in, optional] RPC_BINDING_HANDLE_SECURITY_V1_A *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 戻り値」を参照してください。

注釈

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

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

要件

こちらもご覧ください

RPC_BINDING_HANDLE

RpcBindingBind