función CM_Enumerate_EnumeratorsA (cfgmgr32.h)
La función CM_Enumerate_Enumerators enumera los enumeradores de dispositivos del equipo local proporcionando el nombre de cada enumerador.
Sintaxis
CMAPI CONFIGRET CM_Enumerate_EnumeratorsA(
[in] ULONG ulEnumIndex,
[out] PSTR Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags
);
Parámetros
[in] ulEnumIndex
Índice proporcionado por el autor de la llamada en la lista de enumeradores de dispositivos de la máquina. Para obtener más información, vea la siguiente sección Comentarios .
[out] Buffer
Dirección de un búfer para recibir un nombre de enumerador. Este búfer debe tener MAX_DEVICE_ID_LEN tamaño (o, establecer Buffer en cero y obtener la longitud real del nombre en la ubicación a la que hace referencia puLength).
[in, out] pulLength
Dirección proporcionada por el autor de la llamada de una ubicación para contener el tamaño del búfer. El autor de la llamada proporciona la longitud del búfer al que apunta Buffer. La función reemplaza este valor por el tamaño real de la cadena de nombre del enumerador. Si la longitud del búfer proporcionada por el autor de la llamada es demasiado pequeña, la función proporciona el tamaño de búfer necesario y devuelve CR_BUFFER_SMALL.
[in] ulFlags
No se usa, debe ser 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 los enumeradores de dispositivos del equipo local, llame a CM_Enumerate_Enumerators repetidamente, empezando por un valor de índice ulEnumIndex de cero. e incrementando el valor de índice con cada llamada posterior hasta que la función devuelve CR_NO_SUCH_VALUE.
Una vez obtenidos los nombres del enumerador, los nombres se pueden usar como entrada para CM_Get_Device_ID_List.
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 |