Funzione RpcStringBindingParseW (rpcdce.h)

Articolo
11/20/2024

La funzione rpcStringBindingParse restituisce la parte UUID dell'oggetto e le parti dell'indirizzo di un'associazione di stringhe come stringhe separate. Un'applicazione chiama RpcStringBindingParse per analizzare una rappresentazione di stringa di un handle di associazione nei relativi campi del componente. La funzione rpcStringBindingParse restituisce la parte UUID dell'oggetto e le parti dell'indirizzo di un'associazione di stringhe come stringhe separate.

Sintassi

RPC_STATUS RpcStringBindingParseW(
  RPC_WSTR StringBinding,
  RPC_WSTR *ObjUuid,
  RPC_WSTR *Protseq,
  RPC_WSTR *NetworkAddr,
  RPC_WSTR *Endpoint,
  RPC_WSTR *NetworkOptions
);

Parametri

StringBinding

Puntatore a un nullrappresentazione di stringa con terminazione di un'associazione.

ObjUuid

Restituisce un puntatore a un puntatore a un nullrappresentazione di stringa con terminazione di un oggetto UUID.

Specificare un valore NULL per impedire RpcStringBindingParse di restituire il parametro ObjectUuid . In questo caso, l'applicazione non chiama RpcStringFree.

Protseq

Restituisce un puntatore a un puntatore a un nullrappresentazione di stringa con terminazione di una sequenza di protocollo. Per un elenco delle sequenze di protocollo supportate da Microsoft RPC, vedere binding di stringhe.

Specificare un valore NULL per impedire RpcStringBindingParse di restituire il parametro ProtSeq. In questo caso, l'applicazione non chiama RpcStringFree.

NetworkAddr

Restituisce un puntatore a un puntatore a un nullrappresentazione di stringa con terminazione di un indirizzo di rete. Specificare un valore NULL per impedire rpcStringBindingParse restituire il parametro NetworkAddr . In questo caso, l'applicazione non chiama RpcStringFree.

Endpoint

Restituisce un puntatore a un puntatore a un nullrappresentazione di stringa con terminazione di un endpoint. Specificare un valore NULL per impedire RpcStringBindingParse di restituire il parametro EndPoint. In questo caso, l'applicazione non chiama RpcStringFree.

NetworkOptions

Restituisce un puntatore a un puntatore a un nullrappresentazione di stringa con terminazione delle opzioni di rete.

Specificare un valore NULL per impedire rpcStringBindingParse restituire il parametro NetworkOptions. In questo caso, l'applicazione non chiama RpcStringFree.

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INVALID_STRING_BINDING	L'associazione di stringhe non è valida.

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

Osservazioni

Un'applicazione chiama routine RpcStringBindingParse per analizzare una rappresentazione di stringa di un handle di associazione nei relativi campi del componente.

La libreria di runtime RPC alloca la memoria per ogni stringa del componente restituita. L'applicazione è responsabile della chiamata RpcStringFree una volta per ogni stringa restituita per deallocare la memoria per tale stringa.

Se un campo del parametro StringBinding è vuoto, RpcStringBindingParse restituisce una stringa vuota (\0) nel parametro di output corrispondente.

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 RpcStringBindingParse 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

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree

Condividi tramite