Funzione RpcBindingToStringBindingA (rpcdce.h)

Articolo
11/20/2024

La funzione RpcBindingToStringBinding restituisce una rappresentazione di stringa di un handle di associazione.

Sintassi

RPC_STATUS RpcBindingToStringBindingA(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *StringBinding
);

Parametri

Binding

Handle di associazione client o server da convertire in una rappresentazione di stringa di un handle di associazione.

StringBinding

Restituisce un puntatore a un puntatore alla rappresentazione di stringa dell'handle di associazione specificato nel parametro binding .

Specificare un valore Null per impedire rpcBindingToStringBinding restituire il parametro StringBinding . In questo caso, l'applicazione non chiama la funzione RpcStringFree .

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INVALID_BINDING	L'handle di associazione non è valido.

Nota Per un elenco di codici di errore validi, vedere RPC Return Values.

Osservazioni

La funzione rpcBindingToStringBinding converte un handle di associazione client o server nella relativa rappresentazione di stringa.

La libreria di runtime RPC alloca la memoria per la stringa restituita nel parametro StringBinding. L'applicazione è responsabile della chiamata della funzione RpcStringFree per deallocare tale memoria.

Se l'handle di associazione nel parametro binding contiene un oggetto nil UUID, il campo UUID dell'oggetto non è incluso nella stringa restituita.

Per analizzare il parametro StringBinding restituito , chiamare la funzione rpcStringBindingParse .

Nota Per eseguire una 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 server può essere usato per ottenere un'associazione di stringhe richiamando RpcBindingToStringBinding. Il server può quindi chiamare RpcStringBindingParse per estrarre l'indirizzo di rete del client dall'associazione di stringhe.

Nota

L'intestazione rpcdce.h definisce RpcBindingToStringBinding come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	rpcdce.h (include Rpc.h)
libreria	Rpcrt4.lib
dll	Rpcrt4.dll

Vedere anche

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree

Condividi tramite