Freigeben über


CanUserWritePwrScheme-Funktion (powrprof.h)

[CanUserWritePwrScheme 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 PowerSettingAccessCheck verwenden.]

Bestimmt, ob der aktuelle Benutzer über ausreichende Berechtigungen zum Schreiben eines Energieschemas verfügt.

Syntax

BOOLEAN CanUserWritePwrScheme();

Rückgabewert

Wenn der aktuelle Benutzer über ausreichende Berechtigungen zum Schreiben eines Energieschemas verfügt, gibt die Funktion TRUE zurück.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Mögliche Fehlerwerte sind:

Fehler Bedeutung
ERROR_ACCESS_DENIED
Der aktuelle Benutzer verfügt nicht über ausreichende Berechtigungen zum Schreiben eines Energieschemas.

Hinweise

Diese Funktion ist nützlich, wenn Ihre Anwendung die Identität eines Benutzers antäusst.

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