fonction CM_Get_DevNode_Registry_PropertyA (cfgmgr32.h)

Article
02/23/2024

La fonction CM_Get_DevNode_Registry_Property récupère une propriété d’appareil spécifiée à partir du Registre.

Syntaxe

CMAPI CONFIGRET CM_Get_DevNode_Registry_PropertyA(
  [in]            DEVINST dnDevInst,
  [in]            ULONG   ulProperty,
  [out, optional] PULONG  pulRegDataType,
  [out, optional] PVOID   Buffer,
  [in, out]       PULONG  pulLength,
  [in]            ULONG   ulFlags
);

Paramètres

[in] dnDevInst

Un appareil fourni par l’appelant instance handle lié à l’ordinateur local.

[in] ulProperty

Valeur constante préfixée CM_DRP_ qui identifie la propriété d’appareil à obtenir à partir du Registre. Ces constantes sont définies dans Cfgmgr32.h.

[out, optional] pulRegDataType

Facultatif, peut être NULL. Pointeur vers un emplacement qui reçoit le type de données du Registre, spécifié sous la forme d’une constante préfixée REG_ définie dans Winnt.h.

[out, optional] Buffer

Facultatif, peut être NULL. Pointeur vers une mémoire tampon fournie par l’appelant qui reçoit la propriété d’appareil demandée. Si cette valeur est NULL, la fonction fournit uniquement la longueur des données demandées dans l’adresse pointée par pulLength.

[in, out] pulLength

Pointeur vers une variable ULONG dans laquelle la fonction stocke la longueur, en octets, de la propriété d’appareil demandée.

Si le paramètre Buffer a la valeur NULL, la variable ULONG doit être définie sur zéro.

Si le paramètre Buffer n’est pas défini sur NULL, la variable ULONG doit être définie sur la longueur, en octets, de la mémoire tampon fournie par l’appelant.

[in] ulFlags

Non utilisé, doit être égal à zéro.

Valeur retournée

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

Remarques

Pour plus d’informations sur l’utilisation des handles de instance d’appareil liés à l’ordinateur local, consultez CM_Get_Child.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Microsoft Windows 2000.
Plateforme cible	Universal
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib

Voir aussi

CM_Get_Child
CM_Set_DevNode_Registry_Property
SetupDiGetDeviceRegistryProperty

Partager via