Compartilhar via


Função NetEnumerateComputerNames (lmjoin.h)

A função NetEnumerateComputerNames enumera nomes para o computador especificado.

Sintaxe

NET_API_STATUS NET_API_FUNCTION NetEnumerateComputerNames(
  [in, optional] LPCWSTR                Server,
  [in]           NET_COMPUTER_NAME_TYPE NameType,
  [in]           ULONG                  Reserved,
  [out]          PDWORD                 EntryCount,
  [out]          LPWSTR                 **ComputerNames
);

Parâmetros

[in, optional] Server

Um ponteiro para uma cadeia de caracteres constante que especifica o nome do computador no qual executar essa função. Se esse parâmetro for NULL, o computador local será usado.

[in] NameType

O tipo do nome consultado. Esse membro pode ser um dos valores a seguir definidos na enumeração NET_COMPUTER_NAME_TYPE definida no arquivo de cabeçalho Lmjoin.h .

Valor Significado
NetPrimaryComputerName
O nome do computador primário.
NetAlternateComputerNames
Nomes de computador alternativos.
NetAllComputerNames
Todos os nomes de computador.
NetComputerNameTypeMax
Indica o final do intervalo que especifica os valores possíveis para o tipo de nome a ser consultado.

[in] Reserved

Reservado para uso futuro. Esse parâmetro deve ser NULL.

[out] EntryCount

Um ponteiro para um valor DWORD que retorna o número de nomes retornados no buffer apontado pelo parâmetro ComputerNames se a função for bem-sucedida.

[out] ComputerNames

Um ponteiro para uma matriz de ponteiros para nomes. Se a chamada de função for bem-sucedida, esse parâmetro retornará os nomes de computador que correspondem ao nome do tipo de computador especificado no parâmetro NameType .

Quando o aplicativo não precisar mais dessa matriz, esse buffer deverá ser liberado chamando a função NetApiBufferFree .

Valor retornado

Se a função for bem-sucedida, o valor retornado será NERR_Success.

Se a função falhar, o valor retornado poderá ser um dos códigos de erro a seguir ou um dos códigos de erro do sistema.

Código de retorno Descrição
ERROR_ACCESS_DENIED
O acesso foi negado. Esse erro será retornado se o chamador não for membro do grupo local Administradores no computador de destino.
ERROR_INVALID_PARAMETER
Um parâmetro está incorreto.
ERROR_NOT_ENOUGH_MEMORY
Não há memória suficiente disponível para processar esse comando.
ERROR_NOT_SUPPORTED
A solicitação não terá suporte. Esse erro será retornado se o computador de destino especificado no parâmetro Server no qual essa função é executada estiver em execução no Windows 2000 e anterior.
NERR_WkstaNotStarted
O serviço estação de trabalho não foi iniciado.
RPC_S_CALL_IN_PROGRESS
Uma chamada de procedimento remoto já está em andamento para esse thread.
RPC_S_PROTSEQ_NOT_SUPPORTED
Não há suporte para a sequência de protocolo de chamada de procedimento remoto.

Comentários

A função NetEnumerateComputerNames tem suporte no Windows Vista e posterior.

A função NetEnumerateComputerNames é usada para solicitar os nomes que um computador configurou no momento.

A função NetEnumerateComputerNames requer que o chamador seja membro do grupo local Administradores no computador de destino.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho lmjoin.h (inclua Lm.h)
Biblioteca Netapi32.lib
DLL Netapi32.dll

Confira também

NetAddAlternateComputerName

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx