fonction CM_Modify_Res_Des (cfgmgr32.h)

Article
08/22/2023

La fonction CM_Modify_Res_Des modifie un descripteur de ressource spécifié sur l’ordinateur local.

Syntaxe

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

Paramètres

[out] prdResDes

Pointeur vers un emplacement pour recevoir un handle vers le descripteur de ressource modifié.

[in] rdResDes

Handle fourni par l’appelant pour le descripteur de ressources à modifier. Ce handle doit avoir été obtenu précédemment en appelant l’une des fonctions suivantes :

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

Identificateur de type de ressource fourni par l’appelant. Il doit s’agir de l’une des constantes préfixées ResType_ définies dans Cfgmgr32.h.

[in] ResourceData

Pointeur fourni par l’appelant vers un descripteur de ressources, qui peut être l’une des structures répertoriées sous la description de ResourceData de la fonction CM_Add_Res_Des.

[in] ResourceLen

Longueur fournie par l’appelant de la structure pointée vers ResourceData.

[in] ulFlags

Non utilisé, doit être égal à zéro.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, il retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.

Note À compter de Windows 8, CM_Modify_Res_Des retourne CR_CALL_NOT_IMPLEMENTED lorsqu’il est utilisé dans un scénario Wow64. Pour demander des informations sur les ressources matérielles sur un ordinateur local, il est nécessaire d’implémenter une version native d’architecture de l’application à l’aide des API de ressources matérielles. Par exemple : une application AMD64 pour les systèmes AMD64.

Remarques

Les données de descripteur de ressources fournies par l’appelant remplacent les données existantes. Les valeurs spécifiées pour ResourceID et ResourceLen ne doivent pas correspondre au descripteur de ressources existant.

Si la valeur spécifiée pour ResourceID est ResType_ClassSpecific, le descripteur de ressources spécifié doit être le dernier associé à la configuration logique.

Les appelants de CM_Modify_Res_Des doivent appeler CM_Free_Res_Des_Handle pour libérer le handle de descripteur de ressources, une fois qu’il n’est plus nécessaire.

Les appelants de cette fonction doivent avoir SeLoadDriverPrivilege. (Les privilèges sont décrits dans la documentation Microsoft Windows SDK.)

Configuration requise


Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Voir aussi