Funzione RpcStringBindingCompose (rpcdce.h)

Articolo
03/15/2023

La funzione RpcStringBindingCompose crea un handle di associazione stringa.

Sintassi

RPC_STATUS RpcStringBindingCompose(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

Parametri

ObjUuid

Puntatore a una rappresentazione stringa con terminazione null di un oggetto UUID. Ad esempio, la stringa 6B29FC40-CA47-1067-B31D-00DDD01062DA rappresenta un UUID valido.

ProtSeq

Puntatore a una rappresentazione stringa con terminazione null di una sequenza di protocolli. Vedere la nota.

NetworkAddr

Puntatore a una rappresentazione stringa con terminazione null di un indirizzo di rete. Il formato dell'indirizzo di rete è associato alla sequenza di protocollo. Vedere la nota.

Endpoint

Puntatore a una rappresentazione di stringa con terminazione null di un endpoint. Il formato e il contenuto dell'endpoint sono associati alla sequenza di protocollo. Ad esempio, l'endpoint associato alla sequenza di protocollo ncacn_np è un nome della pipe nel formato \pipe\pipename. Vedere la nota.

Options

Puntatore a una rappresentazione di stringa con terminazione null delle opzioni di rete. La stringa di opzione è associata alla sequenza di protocollo. Vedere la nota.

StringBinding

Restituisce un puntatore a un puntatore a una rappresentazione di stringa con terminazione null di un handle di associazione.

Specificare un valore NULL per impedire a RpcStringBindingCompose di restituire il parametro StringBinding . In questo caso, l'applicazione non chiama RpcStringFree. Vedere la nota.

Nota Per altre informazioni, vedere Associazione di stringhe.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_STRING_UUID	La rappresentazione stringa dell'UUID non è valida.

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

Commenti

Un'applicazione chiama la routine RpcStringBindingCompose per combinare un oggetto UUID, una sequenza di protocolli, un indirizzo di rete, un endpoint e altre opzioni di rete in una rappresentazione stringa di un handle di associazione.

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

Specificare un valore di parametro Null o specificare una stringa vuota (\0) per ogni stringa di input senza dati.

I caratteri della barra rovesciata letterale all'interno delle stringhe del linguaggio C devono essere virgolette. La stringa C effettiva per il nome del server per la sequenza di protocollo ncacn_np viene visualizzata come \\servername e la stringa C effettiva per un nome della pipe viene visualizzata come \pipe\pipename.

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

RpcStringBindingParse

RpcStringFree

Condividi tramite