función CM_Enumerate_Classes_Ex (cfgmgr32.h)

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Enumerate_Classes en su lugar.

La función CM_Enumerate_Classes_Ex , cuando se llama repetidamente, enumera las clases de dispositivo instaladas de una máquina local o remota, proporcionando el GUID de cada clase.

Sintaxis

CMAPI CONFIGRET CM_Enumerate_Classes_Ex(
  [in]           ULONG    ulClassIndex,
  [out]          LPGUID   ClassGuid,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[in] ulClassIndex

Índice proporcionado por el autor de la llamada en la lista de clases de dispositivo de la máquina. Para obtener más información, vea la siguiente sección Comentarios .

[out] ClassGuid

Dirección proporcionada por el autor de la llamada de una estructura GUID (descrita en el Microsoft Windows SDK) para recibir el GUID de una clase de dispositivo.

[in] ulFlags

A partir de Windows 8, los autores de llamadas pueden especificar las marcas siguientes:

CM_ENUMERATE_CLASSES_INSTALLER

Enumerar las clases de configuración de dispositivos.

CM_ENUMERATE_CLASSES_INTERFACE

Enumerar clases de interfaz de dispositivo.

De lo contrario, debe establecerse en cero.

[in, optional] hMachine

Identificador de máquina proporcionado por el autor de la llamada, obtenido de una llamada anterior a CM_Connect_Machine.

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.

 

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

Para enumerar las clases de dispositivo locales o remotas de una máquina remota, llame a CM_Enumerate_Classes_Ex repetidamente, empezando por un valor de índice ulClassIndex de cero e incremente el valor de índice con cada llamada posterior hasta que la función devuelva CR_NO_SUCH_VALUE. Algunos valores de índice pueden representar entradas de lista que contienen datos de clase no válidos, en cuyo caso la función devuelve CR_INVALID_DATA. Este valor devuelto se puede omitir.

Los GUID de clase obtenidos de esta función se pueden usar como entrada para las funciones de instalación del dispositivo.

A partir de Windows 8 y sistemas operativos posteriores, los autores de llamadas pueden usar el miembro ulFlags para especificar qué clases de dispositivo CM_Enumerate_Classes_Ex deben devolver. Antes de Windows 8, CM_Enumerate_Classes_Ex solo devolvía clases de configuración de dispositivos.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y sistemas operativos Windows Server 2012 y versiones posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib
Archivo DLL	Cfgmgr32.dll

Consulte también

CM_Enumerate_Classes