Função RpcBindingFromStringBinding (rpcdce.h)

A função RpcBindingFromStringBinding retorna um identificador de associação de uma representação de cadeia de caracteres de um identificador de associação.

Sintaxe

RPC_STATUS RpcBindingFromStringBinding(
  RPC_CSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

Parâmetros

StringBinding

Ponteiro para uma representação de cadeia de caracteres de um identificador de associação.

Binding

Retorna um ponteiro para o identificador de associação do servidor.

Valor retornado

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_STRING_BINDING	A associação de cadeia de caracteres não é válida.
RPC_S_PROTSEQ_NOT_SUPPORTED	Não há suporte para a sequência de protocolo neste host.
RPC_S_INVALID_RPC_PROTSEQ	A sequência de protocolo não é válida.
RPC_S_INVALID_ENDPOINT_FORMAT	O formato do ponto de extremidade não é válido.
RPC_S_STRING_TOO_LONG	A cadeia de caracteres é muito longa.
RPC_S_INVALID_NET_ADDR	O endereço de rede não é válido.
RPC_S_INVALID_ARG	O argumento não era válido.
RPC_S_INVALID_NAF_ID	O identificador de família de endereços de rede não é válido.

 

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

 

Comentários

A função RpcBindingFromStringBinding cria um identificador de associação de servidor de uma representação de cadeia de caracteres de um identificador de associação. O parâmetro StringBinding não precisa conter um UUID de objeto. Nesse caso, a associação retornada contém um UUID nulo. Se o parâmetro StringBinding fornecido não contiver um campo de ponto de extremidade, o parâmetro Binding retornado será um identificador de associação parcialmente associado. Se o parâmetro StringBinding fornecido contiver um campo de ponto de extremidade, o ponto de extremidade será considerado um ponto de extremidade conhecido. Se o parâmetro StringBinding fornecido não contiver um campo de endereço de host, o parâmetro Binding retornado fará referência ao host local.

Um aplicativo cria uma associação de cadeia de caracteres chamando a função RpcStringBindingCompose ou fornecendo uma constante de cadeia de caracteres. A criação de uma associação de cadeia de caracteres por esse método não envolve o contato com o servidor. Êxito ou falha da API não indicará a disponibilidade do servidor.

Quando um aplicativo terminar de usar o parâmetro Binding , o aplicativo deverá chamar a função RpcBindingFree para liberar a memória usada pelo identificador de associação.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	rpcdce.h (inclua Rpc.h)
Biblioteca	Rpcrt4.lib
DLL	Rpcrt4.dll

Confira também

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose