GetCurrentHwProfileA-Funktion (winbase.h)

Ruft Informationen zum aktuellen Hardwareprofil für den lokalen Computer ab.

Syntax

BOOL GetCurrentHwProfileA(
  [out] LPHW_PROFILE_INFOA lpHwProfileInfo
);

Parameter

[out] lpHwProfileInfo

Ein Zeiger auf eine HW_PROFILE_INFO Struktur, die Informationen zum aktuellen Hardwareprofil empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die GetCurrentHwProfile-Funktion ruft den Anzeigenamen und die GUID-Zeichenfolge (Globally Unique Identifier) für das Hardwareprofil ab. Die Funktion ruft auch den gemeldeten Andockzustand für tragbare Computer mit Dockingstationen ab.

Das System generiert eine GUID für jedes Hardwareprofil und speichert sie als Zeichenfolge in der Registrierung. Sie können GetCurrentHwProfile verwenden, um die GUID-Zeichenfolge abzurufen, die als Registrierungsunterschlüssel unter dem Konfigurationseinstellungsschlüssel Ihrer Anwendung in HKEY_CURRENT_USER verwendet werden soll. Auf diese Weise können Sie die Einstellungen der einzelnen Benutzer für jedes Hardwareprofil speichern. Beispielsweise könnte die Farb-Systemsteuerungsanwendung den Unterschlüssel verwenden, um die Farbeinstellungen der einzelnen Benutzer für verschiedene Hardwareprofile zu speichern, z. B. Profile für den angedockten und nicht angedockten Zustand. Anwendungen, die diese Funktionalität verwenden, können das aktuelle Hardwareprofil beim Start überprüfen und ihre Einstellungen entsprechend aktualisieren.

Anwendungen können auch ihre Einstellungen aktualisieren, wenn eine Systemgerätemeldung, z . B. DBT_CONFIGCHANGED, angibt, dass sich das Hardwareprofil geändert hat.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie das makro _WIN32_WINNT als 0x0400 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Beispiele

#include <windows.h>
#include <stdio.h>
#include <tchar.h>

void main(void) 
{
   HW_PROFILE_INFO   HwProfInfo;
   if (!GetCurrentHwProfile(&HwProfInfo)) 
   {
      _tprintf(TEXT("GetCurrentHwProfile failed with error %lx\n"), 
                 GetLastError());
      return;
   }
   _tprintf(TEXT("DockInfo = %d\n"), HwProfInfo.dwDockInfo);
   _tprintf(TEXT("Profile Guid = %s\n"), HwProfInfo.szHwProfileGuid);
   _tprintf(TEXT("Friendly Name = %s\n"), HwProfInfo.szHwProfileName);
}

Hinweis

Der winbase.h-Header definiert GetCurrentHwProfile 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]
Zielplattform	Windows
Kopfzeile	winbase.h (Windows.h einschließen)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll
APIs	ext-ms-win-advapi32-hwprof-l1-1-0 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

DBT_CONFIGCHANGED

HW_PROFILE_INFO

Systeminformationsfunktionen