REASON_CONTEXT-Struktur (minwinbase.h)

Artikel
03/04/2024

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:

Wert	Bedeutung
POWER_REQUEST_CONTEXT_DETAILED_STRING 0x00000002	Die Detaillierte Struktur identifiziert eine lokalisierbare Zeichenfolgenressource, die den Grund für die Energieanforderung beschreibt.
POWER_REQUEST_CONTEXT_SIMPLE_STRING 0x00000001	Der SimpleReasonString-Parameter enthält eine einfache, nicht lokalisierbare Zeichenfolge, die den Grund für die Energieanforderung beschreibt.

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

PowerCreateRequest

SetWaitableTimerEx

Freigeben über