rpcBindingUnbind 函式 (rpcasync.h)
RpcBindingUnbind函式會解除系結先前由 RpcBindingBindingBind系結的系結控制碼。
語法
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) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |