Função RpcBindingFromStringBindingA (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 RpcBindingFromStringBindingA(
  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 de retorno

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 protocolos 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	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 da família de endereços de rede não é válido.

 

Observação Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

 

Observações

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 objeto UUID. Nesse caso, a associação retornada contém uma UUID nula. Se o parâmetro StringBinding fornecido não contiver um campo de ponto de extremidade, o parâmetro de associação de 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 for concluído usando o parâmetro Binding, o aplicativo deverá chamar a função RpcBindingFree para liberar a memória usada pelo identificador de associação.

Nota

O cabeçalho rpcdce.h define RpcBindingFromStringBinding como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose