Compartir a través de


función CM_Enumerate_Classes (cfgmgr32.h)

La función CM_Enumerate_Classes , cuando se llama repetidamente, enumera las clases de dispositivo instaladas del equipo local proporcionando el GUID de cada clase.

Sintaxis

CMAPI CONFIGRET CM_Enumerate_Classes(
  [in]  ULONG  ulClassIndex,
  [out] LPGUID ClassGuid,
  [in]  ULONG  ulFlags
);

Parámetros

[in] ulClassIndex

Índice proporcionado por el autor de la llamada en la lista de clases de dispositivo de la máquina. Para más información, vea la 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.

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 del equipo local, llame a CM_Enumerate_Classes repetidamente, empezando por un valor 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 deben devolver. Antes de Windows 8, CM_Enumerate_Classes solo devolvía clases de configuración de dispositivos.

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_Ex