fonction CM_Get_HW_Prof_Flags_ExW (cfgmgr32.h)

Article
11/20/2024

[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 le profil matériel indicateurs de configuration spécifiques pour une instance d’appareil sur un ordinateur distant ou un ordinateur local.

Syntaxe

CMAPI CONFIGRET CM_Get_HW_Prof_Flags_ExW(
  [in]           DEVINSTID_W 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 d’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 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.

[in, optional] hMachine

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

Remarque L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à compter de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.

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_ préfixes définis dans Cfgmgr32.h.

Remarques

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

La fonctionnalité d’accès aux machines distantes a été supprimée dans Windows 8 et Windows Server 2012 et versions ultérieures, vous ne pouvez donc pas accéder aux ordinateurs distants lors de l’exécution sur ces versions de Windows.

Note

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

Voir aussi

CM_Get_HW_Prof_Flags

SetupDiGetHwProfileFriendlyNameEx

SetupDiGetHwProfileListEx

Partager via