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