Função CM_Get_Next_Res_Des (cfgmgr32.h)

  • Artigo

A função CM_Get_Next_Res_Des obtém um identificador para o próximo descritor de recursos, de um tipo de recurso especificado, para uma configuração lógica no computador local.

Sintaxe

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

Ponteiro para um local para receber um identificador de descritor de recurso.

[in] rdResDes

Identificador fornecido pelo chamador para um descritor de recurso ou uma configuração lógica. Para obter mais informações, consulte a seção Comentários a seguir.

[in] ForResource

Identificador de tipo de recurso fornecido pelo chamador, indicando o tipo de descritor de recurso que está sendo solicitado. Essa deve ser uma das constantes prefixadas ResType_ definidas em Cfgmgr32.h.

[out, optional] pResourceID

Ponteiro para um local para receber um identificador de tipo de recurso, se ForResourceespecificar ResType_All. Para qualquer outro valor ForResource , os chamadores devem definir isso como NULL.

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

Para enumerar os descritores de recursos de uma configuração lógica, comece chamando CM_Get_Next_Res_Des com o identificador da configuração lógica como o argumento para rdResDes. Isso obtém um identificador para o primeiro descritor de recurso do tipo especificado por ForResource. Em seguida, para cada chamada subsequente para CM_Get_Next_Res_Des, especifique o identificador de descritor obtido mais recentemente como o argumento para rdResDes. Repita até que a função retorne CR_NO_MORE_RES_DES.

Para recuperar as informações armazenadas em um descritor de recursos, chame CM_Get_Res_Des_Data.

Para modificar as informações armazenadas em um descritor de recursos, chame CM_Modify_Res_Des.

Os chamadores de CM_Get_Next_Res_Des devem chamar CM_Free_Res_Des_Handle para desalocar o identificador do descritor de recursos, depois que ele não for mais necessário.

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_Next_Res_Des_Ex