CM_Set_Class_Registry_PropertyA, fonction (cfgmgr32.h)

Article
08/22/2023

La fonction CM_Set_Class_Registry_Property définit ou supprime une propriété d’une classe d’installation d’appareil.

Syntaxe

CMAPI CONFIGRET CM_Set_Class_Registry_PropertyA(
  [in]           LPGUID   ClassGuid,
  [in]           ULONG    ulProperty,
  [in, optional] PCVOID   Buffer,
  [in]           ULONG    ulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Paramètres

[in] ClassGuid

Pointeur vers le GUID qui représente la classe d’installation d’appareil pour laquelle définir une propriété.

[in] ulProperty

Valeur de type ULONG qui identifie la propriété à définir. Cette valeur doit être l’une des valeurs CM_CRP_Xxx décrites pour le paramètre ulProperty de la fonction CM_Get_Class_Registry_Property .

[in, optional] Buffer

Pointeur vers une mémoire tampon qui contient les données de propriété. Ce paramètre est facultatif et peut être défini sur NULL. Pour plus d’informations sur la définition de ce paramètre et du paramètre ulLength correspondant, consultez la section Remarques suivante.

[in] ulLength

Valeur de type ULONG qui spécifie la taille, en octets, des données de propriété.

[in] ulFlags

Réservé à un usage interne uniquement. Doit être défini sur zéro.

[in, optional] hMachine

Handle vers un ordinateur distant sur lequel définir la propriété de classe de configuration d’appareil spécifiée. Ce paramètre est facultatif. Si la valeur est NULL, la propriété est définie sur l’ordinateur local.

Valeur retournée

Si l’opération réussit, CM_Set_Class_Registry_Property retourne CR_SUCCESS. Sinon, la fonction retourne l’un des autres codes CR_Xxx status définis dans Cfgmgr32.h.

Remarques

Si Buffer a la valeur NULL, ulLength doit être défini sur zéro.

Si ulLength est défini sur zéro, la fonction supprime la propriété .

Si Buffer n’est pas défini sur NULL et que ulLength n’est pas défini sur zéro, la valeur fournie doit être la taille correcte pour le type de données REG_Xxx pour la propriété spécifiée dans ulProperty.

Configuration requise


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

Voir aussi

CM_Get_Class_Registry_Property
SetupDiGetClassRegistryProperty
SetupDiSetClassRegistryProperty

Partager via