rpcBindingServerFromClient 函式 (rpcdce.h)

發行項
08/25/2023

應用程式會呼叫 RpcBindingServerFromClient ，將用戶端系結控制碼轉換成部分系結的伺服器系結控制碼。

語法

RPC_STATUS RpcBindingServerFromClient(
  RPC_BINDING_HANDLE ClientBinding,
  RPC_BINDING_HANDLE *ServerBinding
);

參數

ClientBinding

要轉換成伺服器系結控制碼的用戶端系結控制碼。如果指定了零的值，伺服器就會模擬此伺服器執行緒所服務的用戶端。

注意在 Windows NT 4.0 中，此參數不可為 Null 。

ServerBinding

傳回伺服器系結控制碼。

傳回值

值	意義
RPC_S_OK	呼叫成功。
RPC_S_INVALID_BINDING	系結控制碼無效。
RPC_S_WRONG_KIND_OF_BINDING	這是作業的系結錯誤類型。
RPC_S_CANNOT_SUPPORT	無法判斷用戶端的主機。如需支援的通訊協定序列清單，請參閱。

注意如需有效錯誤碼的清單，請參閱 RPC 傳回值。

備註

下列通訊協定序列支援 RpcBindingServerFromClient：

ncadg_ip_udp
ncadg_ipx
ncacn_ip_tcp
ncacn_spx。
windows 2000) 有效ncacn_np (
ncacn_HTTP
ncalrpc

應用程式會從 RPC 執行時間取得用戶端系結控制碼。當遠端程序呼叫抵達伺服器時，執行時間會建立用戶端系結控制碼，其中包含呼叫用戶端的相關資訊。執行時間會將此控制碼傳遞至伺服器管理員函式作為第一個引數。

呼叫 RpcBindingServerFromClient 會將此用戶端控制碼轉換成具有下列屬性的伺服器控制碼：

伺服器控制碼是部分系結的控制碼。它包含呼叫用戶端的網路位址，但缺少端點。
伺服器控制碼包含呼叫用戶端所使用的相同物件 UUID 。這可以是 nil UUID。如需用戶端如何為呼叫指定物件 UUID 的詳細資訊，請參閱RpcBindingsetObject、RpcNsBindingImportBegin、RpcNsBindingLookupBegin和RpcBindingFromStringBinding。
伺服器控制碼不包含任何驗證資訊。

伺服器應用程式必須呼叫 RpcBindingFree ，以釋放不再需要伺服器系結控制碼所使用的資源。

注意若要查詢用戶端的位址，應用程式會從呼叫 RpcBindingServerFromClient 函式開始，以取得部分系結的伺服器系結控制碼。伺服器系結控制碼可用來叫用 RpcBindingToStringBinding 來取得字串系結。然後，伺服器可以呼叫 RpcStringBindingParse，從字串系結擷取用戶端的網路位址。

需求


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