Partager via

fonction CM_Get_HW_Prof_Flags_ExA (cfgmgr32.h)

  • Article

[Cette fonction a été déconseillée et ne doit pas être utilisée.]

La fonction CM_Get_HW_Prof_Flags_Ex récupère les indicateurs de configuration spécifiques au profil matériel d’un appareil instance sur un ordinateur distant ou local.

Syntaxe

CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExA(
  [in]           DEVINSTID_A pDeviceID,
  [in]           ULONG       ulHardwareProfile,
  [out]          PULONG      pulValue,
  [in]           ULONG       ulFlags,
  [in, optional] HMACHINE    hMachine
);

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.

[in, optional] hMachine

Handle de machine retourné par appel à CM_Connect_Machine ou NULL. Si ce paramètre a la valeur NULL, CM_Get_HW_Prof_Flags_Ex récupère les indicateurs de configuration sur l’ordinateur local.

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, CM_Get_HW_Prof_Flags retourne CR_SUCCESS. Sinon, la fonction retourne l’un des codes d’erreur préfixés CR_ définis dans Cfgmgr32.h.

Notes

Pour récupérer la liste des ID de profil matériel actuellement définis sur un ordinateur distant, appelez SetupDiGetHwProfileListEx.

Les fonctionnalités d’accès aux machines distantes ont été supprimées dans les systèmes d’exploitation Windows 8 et Windows Server 2012 et versions ultérieures. Vous ne pouvez donc pas accéder aux machines distantes lors de l’exécution sur ces versions de Windows.

Notes

L’en-tête cfgmgr32.h définit CM_Get_HW_Prof_Flags_Ex 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

   
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

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx