CM_Get_Class_Property_ExW, fonction (cfgmgr32.h)

Article
08/22/2023

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

La fonction CM_Get_Class_Property_ExW récupère une propriété d’appareil définie pour une classe d’interface d’appareil ou une classe de configuration d’appareil.

Syntaxe

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

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 récupérer une propriété d’appareil définie pour la classe 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 périphérique de la propriété de classe d’appareil demandée.

[out] PropertyType

Pointeur vers une variable de type DEVPROPTYPE qui reçoit l’identificateur property-data-type de la propriété de classe d’appareil demandée, où l’identificateur de type de données de propriété est le bit OR entre un identificateur de type de données de base et, si le type de données de base est modifié, un modificateur property-data-type.

[out] PropertyBuffer

Pointeur vers une mémoire tampon qui reçoit la propriété de classe d’appareil demandée. CM_Get_Class_Property_ExW récupère la valeur de propriété demandée uniquement si la mémoire tampon est suffisamment grande pour contenir toutes les données de valeur de propriété. Le pointeur peut être NULL.

[in, out] PropertyBufferSize

Taille, en octets, de la mémoire tampon PropertyBuffer . Si le paramètre PropertyBuffer a la valeur NULL, *PropertyBufferSize doit avoir la valeur zéro. En sortie, si la mémoire tampon n’est pas suffisamment grande pour contenir toutes les données de valeur de propriété, CM_Get_Class_Property_ExW retourne la taille des données, en octets, dans *PropertyBufferSize.

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

[in] hMachine

Handle de machine 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, elle retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.

Remarques

CM_Get_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

SetupDiGetClassProperty

SetupDiGetClassPropertyEx

Partager via