Compartir a través de


Función NetEnumerateComputerNames (lmjoin.h)

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

Consulte también

NetAddAlternateComputerName

NetJoinDomain

NetRemoveAlternateComputerName

NetRenameMachineInDomain

NetSetPrimaryComputerName

NetUnjoinDomain

SetComputerNameEx