Funzione RpcBindingServerFromClient (rpcdce.h)

Articolo
08/25/2023

Un'applicazione chiama RpcBindingServerFromClient per convertire un handle di associazione client in un handle di associazione server parzialmente associato.

Sintassi

RPC_STATUS RpcBindingServerFromClient(
  RPC_BINDING_HANDLE ClientBinding,
  RPC_BINDING_HANDLE *ServerBinding
);

Parametri

ClientBinding

Handle di associazione client da convertire in un handle di associazione server. Se viene specificato un valore pari a zero, il server rappresenta il client che viene servito da questo thread del server.

Nota Questo parametro non può essere NULL in Windows NT 4.0.

ServerBinding

Restituisce un handle di associazione server.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_BINDING	L'handle di associazione non è valido.
RPC_S_WRONG_KIND_OF_BINDING	Questo è stato il tipo di associazione sbagliato per l'operazione.
RPC_S_CANNOT_SUPPORT	Impossibile determinare l'host del client. Vedere Osservazioni per un elenco di sequenze di protocolli supportate.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

Le sequenze di protocolli seguenti supportano RpcBindingServerFromClient:

ncadg_ip_udp
ncadg_ipx
Ncacn_ip_tcp
ncacn_spx.
ncacn_np (efficace con Windows 2000)
ncacn_http
ncalrpc

Un'applicazione ottiene un handle di associazione client dal runtime RPC. Quando la chiamata alla procedura remota arriva a un server, l'esecuzione crea un handle di associazione client contenente informazioni sul client chiamante. Il tempo di esecuzione passa questo handle alla funzione di gestione server come primo argomento.

La chiamata a RpcBindingServerFromClient converte questo handle client in un handle server con queste proprietà:

L'handle del server è un handle parzialmente associato. Contiene un indirizzo di rete per il client chiamante, ma manca un endpoint.
L'handle del server contiene lo stesso UUID dell'oggetto usato dal client chiamante. Questo può essere l'UUID nil. Per altre informazioni su come un client specifica un oggetto UUID per una chiamata, vedere RpcBindingsetObject, RpcNsBindingImportBegin, RpcNsBindingLookupBegin e RpcBindingFromStringBindingBindingBinding.
L'handle del server non contiene informazioni di autenticazione.

L'applicazione server deve chiamare RpcBindingFree per liberare le risorse usate dall'handle di associazione server una volta che non è più necessario.

Nota Per eseguire query sull'indirizzo di un client, un'applicazione inizia chiamando la funzione RpcBindingServerFromClient per ottenere un handle di associazione server parzialmente associato. L'handle di associazione del server può essere usato per ottenere un'associazione stringa richiamando RpcBindingToStringBindingBinding. Il server può quindi chiamare RpcStringBindingParse per estrarre l'indirizzo di rete del client dall'associazione di stringhe.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll