fonction CM_Get_HW_Prof_FlagsW (cfgmgr32.h)

Article
08/22/2023

[À 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_FlagsW(
  [in]  DEVINSTID_W 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

Voir aussi

CM_Get_HW_Prof_Flags_Ex

SetupDiGetHwProfileFriendlyName

SetupDiGetHwProfileList

Partager via