共用方式為


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 伺服器解除系結先前系結的系結控制碼。 您可以使用 RpcBindingSetOptionRpcBindingSetAuthInfoEx等呼叫來修改未系結控制碼。 處於未系結狀態的系結控制碼可以再次系結,並重新用來進行呼叫。

如果在系結控制碼上呼叫目前在解除系結時正在進行 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

另請參閱

RpcBindingBind

RpcBindingFree