Função RpcBindingToStringBindingW (rpcdce.h)

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

Sintaxe

RPC_STATUS RpcBindingToStringBindingW(
  RPC_BINDING_HANDLE Binding,
  RPC_WSTR           *StringBinding
);

Parâmetros

Binding

Identificador de associação de cliente ou servidor para converter em uma representação de cadeia de caracteres de um identificador de associação.

StringBinding

Retorna um ponteiro para um ponteiro para a representação de cadeia de caracteres do identificador de associação especificado no parâmetro Binding .

Especifique um valor nulo para impedir que RpcBindingToStringBinding retorne o parâmetro StringBinding . Nesse caso, o aplicativo não chama a função RpcStringFree .

Valor retornado

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_INVALID_BINDING	O identificador de associação era inválido.

 

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

 

Comentários

A função RpcBindingToStringBinding converte um identificador de associação de cliente ou servidor em sua representação de cadeia de caracteres.

A biblioteca de tempo de execução RPC aloca memória para a cadeia de caracteres retornada no parâmetro StringBinding . O aplicativo é responsável por chamar a função RpcStringFree para desalocar essa memória.

Se o identificador de associação no parâmetro Binding contiver um UUID de objeto nulo, o campo UUID do objeto não será incluído na cadeia de caracteres retornada.

Para analisar o parâmetro StringBinding retornado, chame a função RpcStringBindingParse .

Nota Para consultar o endereço de um cliente, um aplicativo começa chamando a função RpcBindingServerFromClient para obter um identificador de associação de servidor parcialmente associado. O identificador de associação do servidor pode ser usado para obter uma associação de cadeia de caracteres invocando RpcBindingToStringBinding. Em seguida, o servidor pode chamar RpcStringBindingParse para extrair o endereço de rede do cliente da associação de cadeia de caracteres.

 

Observação

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

Requisitos

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

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree