Função CM_Modify_Res_Des (cfgmgr32.h)

  • Artigo

A função CM_Modify_Res_Des modifica um descritor de recurso especificado no computador local.

Sintaxe

CMAPI CONFIGRET CM_Modify_Res_Des(
  [out] PRES_DES   prdResDes,
  [in]  RES_DES    rdResDes,
  [in]  RESOURCEID ResourceID,
  [in]  PCVOID     ResourceData,
  [in]  ULONG      ResourceLen,
  [in]  ULONG      ulFlags
);

Parâmetros

[out] prdResDes

Ponteiro para um local para receber um identificador para o descritor de recursos modificado.

[in] rdResDes

Identificador fornecido pelo chamador para o descritor de recursos a ser modificado. Esse identificador deve ter sido obtido anteriormente chamando uma das seguintes funções:

CM_Add_Res_Des

CM_Add_Res_Des_Ex

CM_Get_Next_Res_Des

CM_Get_Next_Res_Des_Ex

CM_Modify_Res_Des

CM_Modify_Res_Des_Ex

[in] ResourceID

Identificador de tipo de recurso fornecido pelo chamador. Essa deve ser uma das constantes prefixadas ResType_ definidas em Cfgmgr32.h.

[in] ResourceData

Ponteiro fornecido pelo chamador para um descritor de recurso, que pode ser uma das estruturas listadas na descrição da função CM_Add_Res_Des de ResourceData.

[in] ResourceLen

Comprimento fornecido pelo chamador da estrutura apontada por ResourceData.

[in] ulFlags

Não usado, deve ser zero.

Valor retornado

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 A partir do Windows 8, CM_Modify_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

Os dados do descritor de recursos fornecidos pelo chamador substituem os dados existentes. Os valores especificados para ResourceID e ResourceLen não precisam corresponder ao descritor de recurso existente.

Se o valor especificado para ResourceID for ResType_ClassSpecific, o descritor de recurso especificado deverá ser o último associado à configuração lógica.

Os chamadores de CM_Modify_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.

Os chamadores dessa função devem ter SeLoadDriverPrivilege. (Os privilégios são descritos na documentação do SDK do Microsoft Windows.)

Requisitos

   
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_Modify_Res_Des_Ex