PowerCreateRequest-Funktion (winbase.h)

Erstellt ein neues Power Request-Objekt.

Syntax

HANDLE PowerCreateRequest(
  [in] PREASON_CONTEXT Context
);

Parameter

[in] Context

Verweist auf eine REASON_CONTEXT-Struktur , die Informationen zur Energieanforderung enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das Power Request-Objekt.

Wenn die Funktion fehlschlägt, ist der Rückgabewert INVALID_HANDLE_VALUE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn das Power Request-Objekt nicht mehr benötigt wird, verwenden Sie die CloseHandle-Funktion, um das Handle freizugeben und das Objekt sauber.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

PowerClearRequest

PowerSetRequest