fonction CM_Set_Class_Property_ExW (cfgmgr32.h)

Article
08/22/2023

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

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

Syntaxe

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

Paramètres

[in] ClassGUID

Pointeur vers le GUID qui identifie la classe d’interface d’appareil ou la classe de configuration de l’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-la 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 être défini sur 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 pas combiner 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.

[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.

Remarques

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

Configuration requise


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

Voir aussi

CM_Connect_Machine

SetupDiSetClassProperty

Partager via