RpcEpResolveBinding 函式 (rpcdce.h)
RpcEpResolveBinding函式會將部分系結的伺服器系結控制碼解析為完全系結的伺服器系結控制碼。
語法
RPC_STATUS RpcEpResolveBinding(
RPC_BINDING_HANDLE Binding,
RPC_IF_HANDLE IfSpec
);
參數
Binding
部分系結的伺服器系結控制碼,可解析為完全系結的伺服器系結控制碼。
IfSpec
存根產生的結構,指定感興趣的介面。
傳回值
值 | 意義 |
---|---|
|
呼叫成功。 |
|
系結控制碼無效。 |
|
這是作業的系結錯誤種類。 |
注意 如需有效錯誤碼的清單,請參閱 RPC 傳回值。
備註
應用程式會呼叫 RpcEpResolveBinding 函式,將部分系結的伺服器系結控制碼解析為完全系結的系結控制碼。
解析系結控制碼需要介面 UUID 和物件 UUID (,可能是 nil) 。 RPC 執行時間程式庫會要求 Binding 參數所指定的主機上的端點對應服務,以查閱相容伺服器實例的端點。 若要尋找端點,端點對應服務會尋找 IfSpec 參數中介面 UUID 的端點對應資料庫,以及 Binding 參數中的 物件 UUID,如果有的話。
解析系結作業函式的方式取決於指定的系結控制碼是部分或完全系結。 當用戶端指定部分綁定控制碼時,解析系結作業會有下列可能的結果:
- 如果端點對應資料庫中沒有註冊相容的伺服器實例,解析系結作業會傳回EPT_S_NOT_REGISTERED狀態碼。
- 如果在端點對應資料庫中註冊相容的伺服器實例,解析系結作業會傳回完整系結和RPC_S_OK狀態碼。
在部分系結和完全系結的系結案例中,解析系結作業都不會連絡相容的伺服器實例。
注意 呼叫 RpcEpResolveBinding 並非絕對必要。 如果在部分系結的伺服器系結控制碼上進行 RPC 呼叫,RPC 執行時間會花費必要的步驟,讓系結成為完全系結的系結控制碼。 RPC 執行時間會呼叫 RpcEpResolveBinding,但會因為其他快取技術而更有效率地執行此動作。 在 Windows XP 和 Windows 2000 中,應用程式沒有理由呼叫 RpcEpResolveBinding。
需求
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | rpcdce.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |