DeletePwrScheme-Funktion (powrprof.h)

[DeletePwrScheme ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Anwendungen, die für Windows Vista und höher geschrieben wurden, sollten stattdessen PowerDeleteScheme verwenden.]

Löscht das angegebene Energieschema.

Syntax

BOOLEAN DeletePwrScheme(
  [in] UINT uiID
);

Parameter

[in] uiID

Der Index des zu löschenden Energieschemas.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

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

Hinweise

Anwendungen können DeletePwrScheme aufrufen, um ein Energieschema dauerhaft zu löschen. Ein Versuch, das derzeit aktive Energieschema zu löschen, schlägt fehl, wobei der letzte Fehler auf ERROR_ACCESS_DENIED festgelegt ist.

Weitere Informationen zur Verwendung von PowrProf.h finden Sie unter Energieschemas.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	powrprof.h
Bibliothek	PowrProf.lib
DLL	PowrProf.dll

Weitere Informationen

Energieverwaltungsfunktionen

Energieschemas

WritePwrScheme