função CM_Get_Res_Des_Data (cfgmgr32.h)

  • Artigo

A função CM_Get_Res_Des_Data recupera as informações armazenadas em um descritor de recursos no computador local.

Sintaxe

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 fornecido pelo chamador para um descritor de recursos, obtido por uma chamada anterior para CM_Get_Next_Res_Des.

[out] Buffer

Endereço de um buffer para receber o conteúdo de um descritor de recurso. O tamanho do buffer necessário deve ser obtido chamando CM_Get_Res_Des_Data_Size.

[in] BufferLen

Comprimento fornecido pelo chamador do buffer especificado pelo Buffer.

[in] ulFlags

Não usado, deve ser zero.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Nota Começando com Windows 8, CM_Get_Res_Des_Data retorna CR_CALL_NOT_IMPLEMENTED quando usado em um cenário Wow64. Para solicitar informações sobre os recursos de hardware em um computador local, é necessário implementar uma versão nativa da arquitetura do aplicativo usando as APIs de recurso de hardware. Por exemplo: um aplicativo AMD64 para sistemas AMD64.
 

Comentários

As informações retornadas no buffer fornecido pelo Buffer serão formatadas como uma das estruturas de tipo de recurso listadas na descrição de CM_Add_Res_Des, com base no tipo de recurso especificado quando CM_Get_Next_Res_Des foi chamado para obter o identificador do descritor de recursos.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib
DLL Cfgmgr32.dll

Confira também

CM_Get_Res_Des_Data_Ex