Função RpcNsBindingInqEntryName (rpcdce.h)

  • Artigo

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

Nota Não há suporte para essa função no Windows Vista e em sistemas operacionais posteriores.
 

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

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 do nome é inválida.
RPC_S_UNSUPPORTED_NAME_SYNTAX
 Não há suporte para a sintaxe de nome.
RPC_S_INCOMPLETE_NAME
 O nome está incompleto.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

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

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree