fonction CM_Get_HW_Prof_FlagsA (cfgmgr32.h)
[À compter de Windows 8 et Windows Server 2012, cette fonction a été dépréciée et ne doit pas être utilisée.]
La fonction CM_Get_HW_Prof_Flags récupère les indicateurs de configuration spécifiques au profil matériel pour un appareil instance sur un ordinateur local.
Syntaxe
CMAPI CONFIGRET CM_Get_HW_Prof_FlagsA(
[in] DEVINSTID_A pDeviceID,
[in] ULONG ulHardwareProfile,
[out] PULONG pulValue,
[in] ULONG ulFlags
);
Paramètres
[in] pDeviceID
Pointeur vers une chaîne terminée par null qui contient l’ID de instance de l’appareil pour lequel récupérer des indicateurs de configuration spécifiques au profil matériel.
[in] ulHardwareProfile
Variable de type ULONG qui spécifie l’identificateur du profil matériel pour lequel récupérer les indicateurs de configuration. Si ce paramètre est égal à zéro, cette fonction récupère les indicateurs de configuration du profil matériel actuel.
[out] pulValue
Pointeur vers une variable fournie par l’appelant de type ULONG qui reçoit zéro ou un bit OR des indicateurs de configuration suivants définis dans Regstr.h :
CSCONFIGFLAG_BITS
Au niveau du bit OR des autres indicateurs CSCONFIGFLAG_Xxx.
CSCONFIGFLAG_DISABLE
Le instance de l’appareil est désactivé dans le profil matériel spécifié.
CSCONFIGFLAG_DO_NOT_CREATE
Le profil matériel ne prend pas en charge le instance d’appareil spécifié.
CSCONFIGFLAG_DO_NOT_START
Impossible de démarrer l’appareil dans le profil matériel spécifié.
[in] ulFlags
Réservé à un usage interne. Doit être défini sur zéro.
Valeur retournée
Si l’opération réussit, CM_Get_HW_Prof_Flags retourne CR_SUCCESS. Sinon, la fonction retourne l’un des codes d’erreur CR_Xxx définis dans Cfgmgr32.h.
Remarques
Pour récupérer une liste d’ID de profil matériel actuellement définis sur un ordinateur local, appelez SetupDiGetHwProfileList.
Pour récupérer les indicateurs de configuration d’un appareil instance sur un ordinateur distant, appelez CM_Get_HW_Prof_Flags_Ex.
Notes
L’en-tête cfgmgr32.h définit CM_Get_HW_Prof_Flags comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | cfgmgr32.h (inclure Cfgmgr32.h) |
Bibliothèque | Cfgmgr32.lib |