HW_PROFILE_INFOA Struktur (winbase.h)

Artikel
11/20/2024

Enthält Informationen zu einem Hardwareprofil. Die GetCurrentHwProfile--Funktion verwendet diese Struktur, um das aktuelle Hardwareprofil für den lokalen Computer abzurufen.

Syntax

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

Angehörige

dwDockInfo

Der gemeldete Andockzustand des Computers. Dieses Element kann eine Kombination aus den folgenden Bitwerten sein.

Wert	Bedeutung
DOCKINFO_DOCKED 0x2	Der Computer ist angedockt.
DOCKINFO_UNDOCKED 0x1	Der Computer ist abgedocken. Dieses Kennzeichen ist immer für Desktopsysteme festgelegt, die nicht abgedocken werden können.
DOCKINFO_USER_SUPPLIED 0x4	Wenn dieses Flag festgelegt ist, GetCurrentHwProfile den aktuellen Andockstatus aus den Informationen abgerufen, die der Benutzer auf der Seite Hardwareprofile der System Systemsteuerungsanwendung bereitgestellt hat. Wenn kein solcher Wert vorhanden ist oder der Wert auf 0 festgelegt ist, wird dieses Flag festgelegt.
DOCKINFO_USER_DOCKED 0x5	Der Computer wird gemäß den vom Benutzer bereitgestellten Informationen angedockt. Dieser Wert ist eine Kombination aus DOCKINFO_USER_SUPPLIED und DOCKINFO_DOCKED Flags.
DOCKINFO_USER_UNDOCKED 0x6	Der Computer wird gemäß den vom Benutzer bereitgestellten Informationen abgedocken. Dieser Wert ist eine Kombination aus DOCKINFO_USER_SUPPLIED und DOCKINFO_UNDOCKED Flags.

szHwProfileGuid[HW_PROFILE_GUIDLEN]

Die GUID-Zeichenfolge (Globally Unique Identifier) für das aktuelle Hardwareprofil. Die von GetCurrentHwProfile zurückgegebene Zeichenfolge schließt die GUID in geschweifte geschweifte Klammern ein, {}; Zum Beispiel:

{12340001-4980-1920-6788-123456789012}

Sie können diese Zeichenfolge als Registrierungsunterschlüssel unter dem Konfigurationseinstellungenschlüssel Ihrer Anwendung in HKEY_CURRENT_USERverwenden. Auf diese Weise können Sie Einstellungen für jedes Hardwareprofil speichern.

szHwProfileName[MAX_PROFILE_LEN]

Der Anzeigename für das aktuelle Hardwareprofil.

Bemerkungen

Anmerkung

Der winbase.h-Header definiert HW_PROFILE_INFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	winbase.h (enthalten Windows.h)

Siehe auch

GetCurrentHwProfile-

Freigeben über