fonction CM_Modify_Res_Des_Ex (cfgmgr32.h)

Article
08/22/2023

[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée. Utilisez CM_Modify_Res_Des à la place.]

La fonction CM_Modify_Res_Des_Ex modifie un descripteur de ressource spécifié sur un ordinateur local ou distant.

Syntaxe

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

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 ressource, qui peut être l’une des structures répertoriées sous la description de ResourceData de la fonction CM_Add_Res_Des_Ex.

[in] ResourceLen

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

[in] ulFlags

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

[in, optional] hMachine

Handle d’ordinateur fourni par l’appelant, obtenu à partir d’un appel précédent à CM_Connect_Machine.

Note L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.

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_Ex 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_Ex doivent appeler CM_Free_Res_Des_Handle pour libérer le handle de descripteur de ressource, 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.)

Les fonctionnalités d’accès aux machines distantes ont été supprimées dans les systèmes d’exploitation Windows 8 et Windows Server 2012 et versions ultérieures. Vous ne pouvez donc pas accéder aux machines distantes lors de l’exécution sur ces versions de Windows.

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