Função RpcBindingToStringBindingA (rpcdce.h)

Artigo
11/20/2024

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

Sintaxe

RPC_STATUS RpcBindingToStringBindingA(
  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 de retorno

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

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

Observações

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 do 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 objeto nulo UUID, 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.

Observação 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.

Nota

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 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

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree

Compartilhar via