Función NetEnumerateComputerNames (lmjoin.h)

Artículo
08/24/2023

La función NetEnumerateComputerNames enumera los nombres del equipo especificado.

Sintaxis

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

Puntero a una cadena constante que especifica el nombre del equipo en el que se va a ejecutar esta función. Si este parámetro es NULL, se usa el equipo local.

[in] NameType

Tipo del nombre consultado. Este miembro puede ser uno de los siguientes valores definidos en la enumeración NET_COMPUTER_NAME_TYPE definida en el archivo de encabezado Lmjoin.h .

Valor	Significado
NetPrimaryComputerName	Nombre del equipo principal.
NetAlternateComputerNames	Nombres de equipo alternativos.
NetAllComputerNames	Todos los nombres de equipo.
NetComputerNameTypeMax	Indica el final del intervalo que especifica los valores posibles para el tipo de nombre que se va a consultar.

[in] Reserved

Reservado para uso futuro. Este parámetro debe ser NULL.

[out] EntryCount

Puntero a un valor DWORD que devuelve el número de nombres devueltos en el búfer al que apunta el parámetro ComputerNames si la función se realiza correctamente.

[out] ComputerNames

Puntero a una matriz de punteros a nombres. Si la llamada de función se realiza correctamente, este parámetro devolverá los nombres de equipo que coinciden con el nombre de tipo de equipo especificado en el parámetro NameType .

Cuando la aplicación ya no necesita esta matriz, este búfer debe liberarse mediante una llamada a la función NetApiBufferFree .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error o uno de los códigos de error del sistema.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	Se denegó el acceso. Este error se devuelve si el autor de la llamada no era miembro del grupo local Administradores en el equipo de destino.
ERROR_INVALID_PARAMETER	Un parámetro es incorrecto.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente memoria disponible para procesar este comando.
ERROR_NOT_SUPPORTED	No se admite la solicitud. Este error se devuelve si el equipo de destino especificado en el parámetro Server en el que se ejecuta esta función se ejecuta en Windows 2000 y versiones anteriores.
NERR_WkstaNotStarted	No se ha iniciado el servicio Workstation.
RPC_S_CALL_IN_PROGRESS	Ya hay una llamada a procedimiento remoto en curso para este subproceso.
RPC_S_PROTSEQ_NOT_SUPPORTED	No se admite la secuencia de protocolo de llamada a procedimiento remoto.

Comentarios

La función NetEnumerateComputerNames es compatible con Windows Vista y versiones posteriores.

La función NetEnumerateComputerNames se usa para solicitar los nombres que un equipo ha configurado actualmente.

La función NetEnumerateComputerNames requiere que el autor de la llamada sea miembro del grupo local Administradores en el equipo de destino.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmjoin.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll