Função RpcNsBindingInqEntryNameA (rpcdce.h)

Artigo
11/20/2024

A função RpcNsBindingInqEntryName retorna o nome de entrada do qual o identificador de associação veio.

Observação Essa função não tem suporte no Windows Vista e em sistemas operacionais posteriores.

Sintaxe

RPC_STATUS RpcNsBindingInqEntryNameA(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_CSTR           *EntryName
);

Parâmetros

Binding

Identificador de associação cujo nome de entrada de banco de dados de serviço de nome é retornado.

EntryNameSyntax

Sintaxe usada noEntryName .

Para usar a sintaxe especificada na entrada de valor do Registro

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, forneça um valor de RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Retorna o endereço de um ponteiro para o nome da entrada de banco de dados de serviço de nome na qual de associação foi encontrado.

Especifique um valor nulo para impedir que RpcNsBindingInqEntryName retorne o parâmetro EntryName. 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.
RPC_S_NO_ENTRY_NAME	Nenhum nome de entrada para associação.
RPC_S_INVALID_NAME_SYNTAX	A sintaxe de nome é inválida.
RPC_S_UNSUPPORTED_NAME_SYNTAX	A sintaxe de nome não tem suporte.
RPC_S_INCOMPLETE_NAME	O nome está incompleto.

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

Observações

A função RpcNsBindingInqEntryName retorna o nome do nome do serviço de nome– nome da entrada do banco de dados do qual veio um identificador de associação compatível com o cliente.

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

Um nome de entrada é associado apenas a identificadores de associação retornados do RpcNsBindingImportNext, RpcNsBindingLookupNexte funções de RpcNsBindingSelect.

Se o identificador de associação especificado no parâmetro Binding não tiver sido retornado de uma entrada de banco de dados de serviço de nome (por exemplo, se o identificador de associação foi criado chamando RpcBindingFromStringBinding), RpcNsBindingInqEntryName retornará uma cadeia de caracteres vazia ("\0") e um código de status RPC_S_NO_ENTRY_NAME.

Nota

O cabeçalho rpcdce.h define RpcNsBindingInqEntryName 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 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	rpcdce.h (inclua Rpc.h)
biblioteca	Rpcrt4.lib
de DLL	Rpcrt4.dll

Consulte também

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree

Compartilhar via