HW_PROFILE_INFOA structure (winbase.h)

Article
03/03/2024

Contient des informations sur un profil matériel. La fonction GetCurrentHwProfile utilise cette structure pour récupérer le profil matériel actuel de l’ordinateur local.

Syntaxe

typedef struct tagHW_PROFILE_INFOA {
  DWORD dwDockInfo;
  CHAR  szHwProfileGuid[HW_PROFILE_GUIDLEN];
  CHAR  szHwProfileName[MAX_PROFILE_LEN];
} HW_PROFILE_INFOA, *LPHW_PROFILE_INFOA;

Membres

dwDockInfo

État d’ancrage signalé de l’ordinateur. Ce membre peut être une combinaison des valeurs de bits suivantes.

Valeur	Signification
DOCKINFO_DOCKED 0x2	L’ordinateur est ancré.
DOCKINFO_UNDOCKED 0x1	L’ordinateur n’est pas suspendu. Cet indicateur est toujours défini pour les systèmes de bureau qui ne peuvent pas être décompressés.
DOCKINFO_USER_SUPPLIED 0x4	Si cet indicateur est défini, GetCurrentHwProfile a récupéré l’état d’ancrage actuel à partir des informations fournies par l’utilisateur dans la page Profils matériels de l’application panneau de configuration système . S’il n’existe aucune valeur de ce type ou si la valeur est définie sur 0, cet indicateur est défini.
DOCKINFO_USER_DOCKED 0x5	L’ordinateur est ancré, selon les informations fournies par l’utilisateur. Cette valeur est une combinaison des indicateurs DOCKINFO_USER_SUPPLIED et DOCKINFO_DOCKED.
DOCKINFO_USER_UNDOCKED 0x6	L’ordinateur est déplié, selon les informations fournies par l’utilisateur. Cette valeur est une combinaison des indicateurs DOCKINFO_USER_SUPPLIED et DOCKINFO_UNDOCKED.

szHwProfileGuid[HW_PROFILE_GUIDLEN]

Chaîne d’identificateur global unique (GUID) pour le profil matériel actuel. La chaîne retournée par GetCurrentHwProfile entoure le GUID d’accolades, {}; par exemple :

{12340001-4980-1920-6788-123456789012}

Vous pouvez utiliser cette chaîne comme sous-clé de Registre sous la clé des paramètres de configuration de votre application dans HKEY_CURRENT_USER. Cela vous permet de stocker les paramètres de chaque profil matériel.

szHwProfileName[MAX_PROFILE_LEN]

Nom complet du profil matériel actuel.

Remarques

Notes

L’en-tête winbase.h définit HW_PROFILE_INFO 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. La combinaison 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	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	winbase.h (inclure Windows.h)

Voir aussi

GetCurrentHwProfile

Partager via