REASON_CONTEXT-Struktur (minwinbase.h)
Enthält Informationen zu einer Energieanforderung. Diese Struktur wird von den Funktionen PowerCreateRequest und SetWaitableTimerEx verwendet.
Syntax
typedef struct _REASON_CONTEXT {
ULONG Version;
DWORD Flags;
union {
struct {
HMODULE LocalizedReasonModule;
ULONG LocalizedReasonId;
ULONG ReasonStringCount;
LPWSTR *ReasonStrings;
} Detailed;
LPWSTR SimpleReasonString;
} Reason;
} REASON_CONTEXT, *PREASON_CONTEXT;
Member
Version
Die Versionsnummer der Struktur. Dieser Parameter muss auf POWER_REQUEST_CONTEXT_VERSION festgelegt werden.
Flags
Das Format des Grundes für die Energieanforderung. Dieser Parameter kann einer der folgenden Werte sein:
Reason
Eine Union, die entweder aus einer Detaillierten Struktur oder einer Zeichenfolge besteht.
Reason.Detailed
Eine Struktur, die eine lokalisierbare Zeichenfolgenressource identifiziert, um den Grund für die Energieanforderung zu beschreiben.
Reason.Detailed.LocalizedReasonModule
Das Modul, das die Zeichenfolgenressource enthält.
Reason.Detailed.LocalizedReasonId
Die ID der Zeichenfolgenressource.
Reason.Detailed.ReasonStringCount
Die Anzahl der Zeichenfolgen im ReasonStrings-Parameter .
Reason.Detailed.ReasonStrings
Ein Array von Zeichenfolgen, die zur Laufzeit in der Zeichenfolgenressource ersetzt werden sollen.
Reason.SimpleReasonString
Eine nicht lokalisierte Zeichenfolge, die den Grund für die Energieanforderung beschreibt.
Hinweise
Es ist sicher, schreibgeschützte Zeichenfolgen als SimpleReasonString oder ReasonStrings zu übergeben, da die Funktionen PowerCreateRequest und SetWaitableTimerEx aus den Zeichenfolgen lesen und nicht in sie schreiben.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
Kopfzeile | minwinbase.h (einschließlich Windows.h) |
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für