función CM_Get_Res_Des_Data (cfgmgr32.h)

  • Artículo

La función CM_Get_Res_Des_Data recupera la información almacenada en un descriptor de recursos en el equipo local.

Sintaxis

CMAPI CONFIGRET CM_Get_Res_Des_Data(
  [in]  RES_DES rdResDes,
  [out] PVOID   Buffer,
  [in]  ULONG   BufferLen,
  [in]  ULONG   ulFlags
);

Parámetros

[in] rdResDes

Identificador proporcionado por el autor de la llamada a un descriptor de recursos, obtenido por una llamada anterior a CM_Get_Next_Res_Des.

[out] Buffer

Dirección de un búfer para recibir el contenido de un descriptor de recursos. El tamaño de búfer necesario se debe obtener llamando a CM_Get_Res_Des_Data_Size.

[in] BufferLen

Longitud proporcionada por el autor de la llamada del búfer especificado por Buffer.

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

Nota A partir de Windows 8, CM_Get_Res_Des_Data 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 arquitectura de la aplicación mediante las API de recursos de hardware. Por ejemplo: una aplicación AMD64 para sistemas AMD64.
 

Comentarios

La información devuelta en el búfer proporcionado por Buffer tendrá el formato de una de las estructuras de tipo de recurso enumeradas en la descripción de CM_Add_Res_Des, en función del tipo de recurso especificado cuando se llamó a CM_Get_Next_Res_Des para obtener el identificador del descriptor de recursos.

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_Res_Des_Data_Ex