Funzione RpcStringBindingComposeW (rpcdce.h)

Articolo
11/20/2024

La funzione RpcStringBindingCompose crea un handle di associazione di stringhe.

Sintassi

RPC_STATUS RpcStringBindingComposeW(
  RPC_WSTR ObjUuid,
  RPC_WSTR ProtSeq,
  RPC_WSTR NetworkAddr,
  RPC_WSTR Endpoint,
  RPC_WSTR Options,
  RPC_WSTR *StringBinding
);

Parametri

ObjUuid

Puntatore a un nullrappresentazione di stringa con terminazione di un oggetto UUID. Ad esempio, la stringa 6B29FC40-CA47-1067-B31D-00DD010662DA rappresenta un UUID valido.

ProtSeq

Puntatore a un nullrappresentazione di stringa con terminazione di una sequenza di protocollo. Vedere La nota.

NetworkAddr

Puntatore a un nullrappresentazione di stringa con terminazione di un indirizzo di rete. Il formato dell'indirizzo di rete è associato alla sequenza di protocollo. Vedere La nota.

Endpoint

Puntatore a un nullrappresentazione di stringa con terminazione 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 di pipe nel formato \pipe\pipename. Vedere La nota.

Options

Puntatore a un nullrappresentazione di stringa con terminazione delle opzioni di rete. La stringa di opzione è associata alla sequenza di protocollo. Vedere La nota.

StringBinding

Restituisce un puntatore a un puntatore a un nullrappresentazione di stringa con terminazione di un handle di associazione.

Specificare un valore NULL per impedire rpcStringBindingCompose 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	Chiamata riuscita.
RPC_S_INVALID_STRING_UUID	La rappresentazione di stringa dell'UUID non è valida.

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

Osservazioni

Un'applicazione chiama routine RpcStringBindingCompose per combinare un UUID oggetto, una sequenza di protocollo, un indirizzo di rete, un endpoint e altre opzioni di rete in una rappresentazione di 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 RpcStringFree per deallocare tale memoria.

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

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

Nota

L'intestazione rpcdce.h definisce RpcStringBindingCompose 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

RpcStringBindingParse

RpcStringFree

Condividi tramite