structure HW_PROFILE_INFOA (winbase.h)

Article
11/20/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 mis en place. Cet indicateur est toujours défini pour les systèmes de bureau qui ne peuvent pas être mis en place.
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 du 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é, en fonction des informations fournies par l’utilisateur. Cette valeur est une combinaison des indicateurs DOCKINFO_USER_SUPPLIED et DOCKINFO_DOCKED.
DOCKINFO_USER_UNDOCKED 0x6	L’ordinateur n’est pas suspendu, 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 place le GUID dans des accolades, {}; par exemple:

{12340001-4980-1920-6788-123456789012}

Vous pouvez utiliser cette chaîne comme sous-clé de Registre sous la clé de 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

Note

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. 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	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	winbase.h (inclure Windows.h)

Voir aussi

GetCurrentHwProfile

Partager via