RpcBindingUnbind 関数 (rpcasync.h)

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

構文

RPC_STATUS RpcBindingUnbind(
  [in] RPC_BINDING_HANDLE Binding
);

パラメーター

[in] Binding

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

戻り値

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

解説

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

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

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

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

要件

関連項目

RpcBindingBind

RpcBindingFree