fonction CM_Get_DevNode_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_Get_DevNode_Property à la place.]

La fonction CM_Get_DevNode_Property_ExW récupère une propriété de instance d’appareil.

Syntaxe

CMAPI CONFIGRET CM_Get_DevNode_Property_ExW(
  [in]           DEVINST          dnDevInst,
  [in]           const DEVPROPKEY *PropertyKey,
  [out]          DEVPROPTYPE      *PropertyType,
  [out]          PBYTE            PropertyBuffer,
  [in, out]      PULONG           PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

Paramètres

[in] dnDevInst

Le instance de l’appareil qui est lié à l’ordinateur local.

[in] PropertyKey

Pointeur vers une structure DEVPROPKEY qui représente la clé de propriété de l’appareil demandé instance propriété.

[out] PropertyType

Pointeur vers une variable de type DEVPROPTYPE qui reçoit l’identificateur de type de données de propriété de la propriété de l’appareil demandé instance propriété, où l’identificateur de type de données de propriété correspond au niveau du bit OU entre un identificateur de type de données de base et, si le type de données de base est modifié, un modificateur de type de données de propriété.

[out] PropertyBuffer

Pointeur vers une mémoire tampon qui reçoit l’appareil demandé instance propriété. CM_Get_DevNode_Property_ExW récupère la 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 avoir la valeur NULL.

[in, out] PropertyBufferSize

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

[in] ulFlags

Réservé. Doit être défini sur 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.

Notes

CM_Get_DevNode_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

SetupDiGetDeviceProperty

Partager via