rpcBindingReset 函式 (rpcdce.h)

RpcBindingReset函式會重設系結控制碼,以便指定主機,但該主機上的伺服器未指定。

語法

RPC_STATUS RpcBindingReset(
  RPC_BINDING_HANDLE Binding
);

參數

Binding

要重設的伺服器系結控制碼。

傳回值

意義
RPC_S_OK
呼叫成功。
RPC_S_INVALID_BINDING
系結控制碼無效。
RPC_S_WRONG_KIND_OF_BINDING
這是作業的系結錯誤類型。
 
注意 如需有效錯誤碼的清單,請參閱 RPC 傳回值
 

備註

用戶端會呼叫 RpcBindingReset 函式,將特定伺服器實例與 Binding 參數中指定的伺服器系結控制碼解除關聯。 RpcBindingReset函式會移除系結控制碼中伺服器位址的端點部分,以解除伺服器實例的關聯。 主機在系結控制碼中保持不變。 結果是部分系結的伺服器系結控制碼。

RpcBindingReset 不會影響 Binding 參數的驗證資訊,如果有的話。

如果用戶端願意由系結控制碼中指定的主機上的任何相容伺服器實例提供服務,用戶端會先呼叫RpcBindingReset函式,再使用系結系結控制碼進行遠端程序呼叫。 用戶端不得針對正在執行呼叫的系結控制碼呼叫 RpcBindingReset 函式。

當用戶端使用重設 (部分系結) 系結進行下一個遠端程序呼叫時,用戶端的 RPC 執行時間程式庫會使用來自用戶端介面規格的已知端點。如果有的話。 否則,用戶端的執行時間程式庫會自動與指定遠端主機上的端點對應服務通訊,以從端點對應資料庫取得相容伺服器的端點。 如果找到相容的伺服器,RPC 執行時間程式庫會以新的端點更新系結。 如果找不到相容的伺服器,遠端程序呼叫就會失敗。 針對使用連線通訊協定 (ncacn) 的呼叫,會將EPT_S_NOT_REGISTERED狀態碼傳回給用戶端。 對於使用資料包通訊協定 (ncadg) 的呼叫,會將RPC_S_COMM_FAILURE狀態碼傳回給用戶端。

伺服器應用程式應該呼叫 RpcEpRegister 和RpcEpRegisterNoReplace來註冊所有系結控制碼,如果伺服器想要讓在重設系結控制碼上進行遠端程序呼叫的用戶端使用。

需求

   
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 rpcdce.h (包含 Rpc.h)
程式庫 Rpcrt4.lib
Dll Rpcrt4.dll

另請參閱

RpcEpRegister

RpcEpRegisterNoReplace