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) |