Funzione RpcStringBindingCompose (rpcdce.h)

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.

Valore restituito

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

Vedi anche

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree