Funzione RpcBindingFromStringBinding (rpcdce.h)

  • Articolo

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

Sintassi

RPC_STATUS RpcBindingFromStringBinding(
  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
 La chiamata ha avuto esito positivo.
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 Valori restituiti RPC.
 

Commenti

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 UUID dell'oggetto. In questo caso, l'associazione restituita contiene un UUID nullo. 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 StringBinding 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 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'uso del parametro Binding , l'applicazione deve chiamare la funzione RpcBindingFree per rilasciare la memoria usata dall'handle di associazione.

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

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose