Share via

Função RpcNsEntryExpandNameA (rpcnsi.h)

  • Artigo

A função RpcNsEntryExpandName expande um nome de entrada nome-serviço. Essa função tem suporte do Active Directory.

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

Sintaxe

RPC_STATUS RpcNsEntryExpandNameA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_CSTR      *ExpandedName
);

Parâmetros

EntryNameSyntax

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

Ponteiro para o nome da entrada a ser expandido.

ExpandedName

Retorna um ponteiro para um ponteiro para a versão expandida de EntryName.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
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

Um aplicativo chama a função RpcNsEntryExpandName para obter um nome de entrada totalmente expandido.

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

As contas de nome de entrada expandidas retornadas para traduções de nome local e para diferenças no esquema de nomenclatura definido localmente.

Nota Essa função requer suporte do Active Directory.
 

Observação

O cabeçalho rpcnsi.h define RpcNsEntryExpandName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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 rpcnsi.h (inclua Rpc.h)
Biblioteca Rpcns4.lib
DLL Rpcns4.dll

Confira também

RpcStringFree