Funzione RpcBindingFromStringBindingA (rpcdce.h)

Articolo
11/20/2024

La funzione RpcBindingFromStringBinding restituisce un handle di associazione da una rappresentazione di stringa di un handle di associazione.

Sintassi

RPC_STATUS RpcBindingFromStringBindingA(
  RPC_CSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

Parametri

StringBinding

Puntatore a una rappresentazione di stringa di un handle di associazione.

Binding

Restituisce un puntatore all'handle di associazione server.

Valore restituito

Valore	Significato
RPC_S_OK	Chiamata riuscita.
RPC_S_INVALID_STRING_BINDING	L'associazione di stringhe non è valida.
RPC_S_PROTSEQ_NOT_SUPPORTED	Sequenza di protocollo non supportata in questo host.
RPC_S_INVALID_RPC_PROTSEQ	La sequenza di protocollo non è valida.
RPC_S_INVALID_ENDPOINT_FORMAT	Il formato dell'endpoint non è valido.
RPC_S_STRING_TOO_LONG	Stringa troppo lunga.
RPC_S_INVALID_NET_ADDR	L'indirizzo di rete non è valido.
RPC_S_INVALID_ARG	L'argomento non è valido.
RPC_S_INVALID_NAF_ID	L'identificatore della famiglia di indirizzi di rete non è valido.

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

Osservazioni

La funzione RpcBindingFromStringBinding crea un handle di associazione server da una rappresentazione di stringa di un handle di associazione. Il parametro StringBinding non deve contenere un oggetto UUID. In questo caso, l'associazione restituita contiene un UUID nil. Se il parametro StringBinding specificato non contiene un campo endpoint, il parametro Binding restituito è un handle di associazione parzialmente associato. Se il parametro StringBinding specificato contiene un campo endpoint, l'endpoint viene considerato un endpoint noto. Se il parametro StringBind ing specificato non contiene un campo indirizzo host, il parametro Binding restituito fa riferimento all'host locale.

Un'applicazione crea un'associazione di stringhe chiamando la funzione rpcStringBindingCompose o fornendo una costante di stringa di caratteri. La creazione di un'associazione di stringa da questo metodo non comporta il contatto con il server. L'esito positivo o negativo dell'API non indicherà la disponibilità del server.

Al termine dell'utilizzo del parametro binding di un'applicazione, l'applicazione deve chiamare la funzione RpcBindingFree per rilasciare la memoria usata dall'handle di associazione.

Nota

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

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose

Condividi tramite