CM_Set_Class_PropertyW, fonction (cfgmgr32.h)

La fonction CM_Set_Class_Property définit une propriété de classe pour une classe d’installation d’appareil ou une classe d’interface d’appareil.

Syntaxe

CMAPI CONFIGRET CM_Set_Class_PropertyW(
  [in] LPCGUID          ClassGUID,
  [in] const DEVPROPKEY *PropertyKey,
  [in] DEVPROPTYPE      PropertyType,
  [in] const PBYTE      PropertyBuffer,
  [in] ULONG            PropertyBufferSize,
  [in] ULONG            ulFlags
);

Paramètres

[in] ClassGUID

Pointeur vers le GUID qui identifie la classe d’interface d’appareil ou la classe de configuration d’appareil pour laquelle définir une propriété d’appareil. Pour plus d’informations sur la spécification du type de classe, consultez le paramètre ulFlags .

[in] PropertyKey

Pointeur vers une structure DEVPROPKEY qui représente la clé de propriété de la propriété de classe d’appareil à définir.

[in] PropertyType

Valeur de type DEVPROPTYPE qui représente l’identificateur de type property-data pour la propriété de classe d’appareil. Pour supprimer une propriété, définissez cette propriété sur DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

Pointeur vers une mémoire tampon qui contient la valeur de propriété de la propriété de classe d’appareil. Si la propriété ou les données doivent être supprimées, ce pointeur doit avoir la valeur NULL et PropertyBufferSize doit avoir la valeur zéro.

[in] PropertyBufferSize

Taille, en octets, de la mémoire tampon PropertyBuffer . Si PropertyBuffer a la valeur NULL, PropertyBufferSize doit avoir la valeur zéro.

[in] ulFlags

Indicateurs de propriété de classe :

CM_CLASS_PROPERTY_INSTALLER

ClassGUID spécifie une classe de configuration d’appareil. Ne combinez pas avec CM_CLASS_PROPERTY_INTERFACE.

CM_CLASS_PROPERTY_INTERFACE

ClassGUID spécifie une classe d’interface d’appareil. Ne combinez pas avec CM_CLASS_PROPERTY_INSTALLER.

Valeur retournée

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

Remarques

CM_Set_Class_Property fait partie du modèle de propriété d’appareil unifié.

Configuration requise

Voir aussi

SetupDiSetClassProperty