Função RpcBindingToStringBinding (rpcdce.h)

  • Artigo

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

Sintaxe

RPC_STATUS RpcBindingToStringBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *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.
 

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

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree