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.
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 |