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 |