Funzione RpcStringBindingParse (rpcdce.h)

Articolo
03/15/2023

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

Sintassi

RPC_STATUS RpcStringBindingParse(
  RPC_CSTR StringBinding,
  RPC_CSTR *ObjUuid,
  RPC_CSTR *Protseq,
  RPC_CSTR *NetworkAddr,
  RPC_CSTR *Endpoint,
  RPC_CSTR *NetworkOptions
);

Parametri

StringBinding

Puntatore a una rappresentazione di stringa con terminazione Null di un'associazione.

ObjUuid

Restituisce un puntatore a un puntatore a una rappresentazione di stringa con terminazione Null di un UUID dell'oggetto.

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

Protseq

Restituisce un puntatore a un puntatore a una rappresentazione di stringa con terminazione Null di una sequenza di protocollo. Per un elenco delle sequenze di protocollo supportate da MICROSOFT RPC, vedere Associazione di stringhe.

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

NetworkAddr

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

Endpoint

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

NetworkOptions

Restituisce un puntatore a un puntatore a una rappresentazione di stringa con terminazione Null delle opzioni di rete.

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

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_STRING_BINDING	L'associazione di stringhe non è valida.

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

Commenti

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

La libreria di runtime RPC alloca la memoria per ogni stringa del componente restituita. L'applicazione è responsabile della chiamata di 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 viene avviata 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.

Requisiti

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	Windows
Intestazione	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll

Vedi anche

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree

Share via