Share via

función CM_Get_Next_Res_Des (cfgmgr32.h)

  • Artículo

La función CM_Get_Next_Res_Des obtiene un identificador para el siguiente descriptor de recursos, de un tipo de recurso especificado, para una configuración lógica en el equipo local.

Sintaxis

CMAPI CONFIGRET CM_Get_Next_Res_Des(
  [out]           PRES_DES    prdResDes,
  [in]            RES_DES     rdResDes,
  [in]            RESOURCEID  ForResource,
  [out, optional] PRESOURCEID pResourceID,
  [in]            ULONG       ulFlags
);

Parámetros

[out] prdResDes

Puntero a una ubicación para recibir un identificador de descriptor de recursos.

[in] rdResDes

Identificador proporcionado por el autor de la llamada a un descriptor de recursos o a una configuración lógica. Para obtener más información, vea la siguiente sección Comentarios .

[in] ForResource

Identificador de tipo de recurso proporcionado por el autor de la llamada, que indica el tipo de descriptor de recursos que se solicita. Debe ser una de las constantes ResType_ prefijo definidas en Cfgmgr32.h.

[out, optional] pResourceID

Puntero a una ubicación para recibir un identificador de tipo de recurso, si ForResource especifica ResType_All. Para cualquier otro valor forResource , los llamadores deben establecerlo en NULL.

[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 CR_ prefijo definidos en Cfgmgr32.h.

Nota A partir de Windows 8, CM_Get_Next_Res_Des devuelve CR_CALL_NOT_IMPLEMENTED cuando se usa en un escenario wow64. Para solicitar información sobre los recursos de hardware en un equipo local, es necesario implementar una versión nativa de la arquitectura de la aplicación mediante las API de recursos de hardware. Por ejemplo: una aplicación AMD64 para sistemas AMD64.
 

Comentarios

Para enumerar los descriptores de recursos de una configuración lógica, comience llamando a CM_Get_Next_Res_Des con el identificador de la configuración lógica como argumento para rdResDes. Esto obtiene un identificador para el primer descriptor de recursos del tipo especificado por ForResource. A continuación, para cada llamada posterior a CM_Get_Next_Res_Des, especifique el identificador de descriptor obtenido más recientemente como argumento para rdResDes. Repita hasta que la función devuelva CR_NO_MORE_RES_DES.

Para recuperar la información almacenada en un descriptor de recursos, llame a CM_Get_Res_Des_Data.

Para modificar la información almacenada en un descriptor de recursos, llame a CM_Modify_Res_Des.

Los autores de llamadas de CM_Get_Next_Res_Des deben llamar a CM_Free_Res_Des_Handle para desasignar el identificador del descriptor de recursos, después de que ya no sea necesario.

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_Get_Next_Res_Des_Ex