Função NetEnumerateComputerNames (lmjoin.h)

Artigo
08/24/2023

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