funzione CM_Modify_Res_Des (cfgmgr32.h)

Articolo
03/08/2023

La funzione CM_Modify_Res_Des modifica un descrittore di risorse specificato nel computer locale.

Sintassi

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
);

Parametri

[out] prdResDes

Puntatore a una posizione per ricevere un handle al descrittore di risorsa modificato.

[in] rdResDes

Handle fornito dal chiamante al descrittore di risorse da modificare. Questo handle deve essere stato ottenuto in precedenza chiamando una delle funzioni seguenti:

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

Identificatore del tipo di risorsa fornito dal chiamante. Questa deve essere una delle costanti con prefisso ResType_ definite in Cfgmgr32.h.

[in] ResourceData

Puntatore fornito dal chiamante a un descrittore di risorse, che può essere una delle strutture elencate nella descrizione della funzione CM_Add_Res_Des di ResourceData.

[in] ResourceLen

Lunghezza fornita dal chiamante della struttura a cui fa riferimento ResourceData.

[in] ulFlags

Non usato, deve essere zero.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Nota A partire da Windows 8, CM_Modify_Res_Des restituisce CR_CALL_NOT_IMPLEMENTED quando viene usato in uno scenario Wow64. Per richiedere informazioni sulle risorse hardware in un computer locale, è necessario implementare una versione nativa dell'architettura dell'applicazione usando le API delle risorse hardware. Ad esempio: un'applicazione AMD64 per sistemi AMD64.

Commenti

I dati del descrittore di risorse forniti dal chiamante sostituiscono i dati esistenti. I valori specificati per ResourceID e ResourceLen non devono corrispondere al descrittore di risorse esistente.

Se il valore specificato per ResourceID è ResType_ClassSpecific, il descrittore di risorse specificato deve essere l'ultimo associato alla configurazione logica.

I chiamanti di CM_Modify_Res_Des devono chiamare CM_Free_Res_Des_Handle per deallocare l'handle del descrittore di risorse, dopo che non è più necessario.

I chiamanti di questa funzione devono avere SeLoadDriverPrivilege. I privilegi sono descritti nella documentazione di Microsoft Windows SDK.

Requisiti


Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Vedi anche