função CM_Modify_Res_Des_Ex (cfgmgr32.h)

  • Artigo

[A partir do Windows 8 e do Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Modify_Res_Des .]

A função CM_Modify_Res_Des_Ex modifica um descritor de recurso especificado em um computador local ou remoto.

Sintaxe

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

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 por ResType_ definidas em Cfgmgr32.h.

[in] ResourceData

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

[in] ResourceLen

Comprimento fornecido pelo chamador da estrutura apontada por ResourceData.

[in] ulFlags

Não usado, deve ser zero.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador, obtido de uma chamada anterior para CM_Connect_Machine.

Nota Não há suporte para o uso dessa função para acessar computadores remotos a partir do Windows 8 e do Windows Server 2012, pois essa funcionalidade foi removida.
 

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_Ex 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 recursos especificado deverá ser o último associado à configuração lógica.

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

A funcionalidade para acessar computadores remotos foi removida nos sistemas operacionais Windows 8 e Windows Server 2012 e posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do 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