fonction CM_Get_HW_Prof_FlagsA (cfgmgr32.h)
[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée et ne doit pas être utilisée.]
La fonction CM_Get_HW_Prof_Flags récupère le profil matériel indicateurs de configuration spécifiques pour une instance d’appareil 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 d’instance d’appareil 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 des 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 au niveau du bit OR des indicateurs de configuration suivants définis dans Regstr.h:
CSCONFIGFLAG_BITS
Or au niveau du bit des autres indicateurs de CSCONFIGFLAG_Xxx.
CSCONFIGFLAG_DISABLE
L’instance de l’appareil est désactivée dans le profil matériel spécifié.
CSCONFIGFLAG_DO_NOT_CREATE
Le profil matériel ne prend pas en charge l’instance d’appareil spécifiée.
CSCONFIGFLAG_DO_NOT_START
L’appareil ne peut pas être démarré dans le profil matériel spécifié.
[in] ulFlags
Réservé à une utilisation interne. Doit être défini sur zéro.
Valeur de retour
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 la liste des ID de profil matériel actuellement définis sur un ordinateur local, appelez SetupDiGetHwProfileList.
Pour récupérer des indicateurs de configuration pour une instance d’appareil sur un ordinateur distant, appelez CM_Get_HW_Prof_Flags_Ex.
Note
L’en-tête cfgmgr32.h définit CM_Get_HW_Prof_Flags en tant qu’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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Bureau |
| d’en-tête | cfgmgr32.h (include Cfgmgr32.h) |
| bibliothèque | Cfgmgr32.lib |