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);
}

Anforderungen

Weitere Informationen

DBT_CONFIGCHANGED

HW_PROFILE_INFO

Systeminformationsfunktionen