Share via

HW_PROFILE_INFOA-Struktur (winbase.h)

  • Artikel

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;

Member

dwDockInfo

Der gemeldete Andockzustand des Computers. Dieser Member kann eine Kombination der folgenden Bitwerte sein.

Wert Bedeutung
DOCKINFO_DOCKED
0x2
 Der Computer ist angedockt.
DOCKINFO_UNDOCKED
0x1
 Der Computer ist abgedockt. Dieses Flag ist immer für Desktopsysteme festgelegt, die nicht abgedockt werden können.
DOCKINFO_USER_SUPPLIED
0x4
 Wenn dieses Flag festgelegt ist, hat GetCurrentHwProfile den aktuellen Andockzustand aus den Informationen abgerufen, die der Benutzer auf der Seite Hardwareprofile der 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 ist angedockt, gemäß den Vom Benutzer bereitgestellten Informationen. Dieser Wert ist eine Kombination aus den flags DOCKINFO_USER_SUPPLIED und DOCKINFO_DOCKED.
DOCKINFO_USER_UNDOCKED
0x6
 Der Computer wird nach Angaben des Benutzers abgedockt. Dieser Wert ist eine Kombination aus den flags DOCKINFO_USER_SUPPLIED und DOCKINFO_UNDOCKED.

szHwProfileGuid[HW_PROFILE_GUIDLEN]

Die GUID-Zeichenfolge (Globally Unique Identifier) für das aktuelle Hardwareprofil. Die von GetCurrentHwProfile zurückgegebene Zeichenfolge umschließt die GUID in geschweifte Klammern, {}z. B.:

{12340001-4980-1920-6788-123456789012}

Sie können diese Zeichenfolge als Registrierungsunterschlüssel unter dem Konfigurationseinstellungsschlüssel Ihrer Anwendung in HKEY_CURRENT_USER verwenden. Dadurch können Sie Einstellungen für jedes Hardwareprofil speichern.

szHwProfileName[MAX_PROFILE_LEN]

Der Anzeigename für das aktuelle Hardwareprofil.

Hinweise

Hinweis

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
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile winbase.h (Windows.h einschließen)

Weitere Informationen

GetCurrentHwProfile