RpcBindingUnbind 関数 (rpcasync.h)

RpcBindingUnbind 関数は、以前に RpcBindingBind によってバインドされたバインド ハンドルをバインド解除します。

構文

RPC_STATUS RpcBindingUnbind(
  [in] RPC_BINDING_HANDLE Binding
);

パラメーター

[in] Binding

RPC_BINDING_HANDLE RPC サーバーからバインド解除するバインド ハンドルを含む構造体です。

戻り値

この関数は、成功したRPC_S_OKを返します。それ以外の場合は、RPC_S_* エラー コードが返されます。

メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。

 

解説

RpcBindingUnbind は、以前にバインドされたバインド ハンドルを RPC サーバーからバインド解除します。 バインドされていないハンドルは、 RpcBindingSetOption や RpcBindingSetAuthInfoEx などの呼び出しで変更できます。 非バインド状態のバインド ハンドルを再度バインドし、呼び出しを行うために再利用できます。

バインド解除操作の結果は、バインド解除時に現在 RPC 呼び出しが進行中のバインド ハンドルで呼び出された場合、未定義になります。 バインド解除操作が試行された時点で、呼び出しが進行中でないことを確認するのは呼び出し元の責任です。

RpcBindingUnbind を呼び出しても、必ずしもクライアントがサーバーから切断されるわけではないことに注意してください。 バインド ハンドルによって使用されるキャッシュされた情報は無効になりますが、実際には切断は保証されません。 切断を確保するには、 RpcBindingFree を使用してバインド ハンドルを解放します。

Windows Vista: 現在、この関数は ncalrpc プロトコル シーケンスのみをサポートしています。

要件

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

関連項目

RpcBindingBind

RpcBindingFree