Compartilhar via


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