次の方法で共有

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 戻り値を参照してください。

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

備考

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

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

手記

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

必要条件

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

関連項目

RPC_BINDING_HANDLE

RpcBindingBind の