Função RpcNsBindingInqEntryName (rpcdce.h)

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

Sintaxe

RPC_STATUS RpcNsBindingInqEntryName(
  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 em EntryName.

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 name-service na qual Binding foi encontrada.

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 retornado

Comentários

A função RpcNsBindingInqEntryName retorna o nome do nome da entrada de banco de dados do serviço de nome 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 das funções RpcNsBindingImportNext, RpcNsBindingLookupNext e RpcNsBindingSelect .

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

Requisitos

Confira também

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree