CM_Get_Device_Interface_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_Device_Interface_Property à la place.]

La fonction CM_Get_Device_Interface_Property_ExW récupère une propriété d’appareil définie pour une interface d’appareil.

Syntaxe

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

Paramètres

[in] pszDeviceInterface

Pointeur vers une chaîne qui identifie l’interface de l’appareil instance à partir de laquelle récupérer la propriété.

[in] PropertyKey

Pointeur vers une structure DEVPROPKEY qui représente la clé de propriété d’interface d’appareil de la propriété d’interface d’appareil à récupérer.

[out] PropertyType

Pointeur vers une variable de type DEVPROPTYPE qui reçoit l’identificateur de type property-data de la propriété d’interface d’appareil demandée. L’identificateur de type de données de propriété est 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 propriété-données.

[out] PropertyBuffer

Pointeur vers une mémoire tampon qui reçoit la propriété d’interface d’appareil demandée. CM_Get_Device_Interface_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 être 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_Device_Interface_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 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_Device_Interface_Property_ExW fait partie du modèle de propriété d’appareil unifié.

Configuration requise

Condition requise	Valeur
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
DLL	CfgMgr32.dll

Voir aussi

CM_Connect_Machine

SetupDiGetDeviceInterfaceProperty

Partager via