структура REASON_CONTEXT (minwinbase.h)

Содержит сведения о запросе питания. Эта структура используется функциями PowerCreateRequest и SetWaitableTimerEx .

Синтаксис

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;

Члены

Version

Номер версии структуры. Для этого параметра необходимо задать значение POWER_REQUEST_CONTEXT_VERSION.

Flags

Формат причины запроса на питание. Этот параметр может иметь одно из следующих значений:

Reason

Объединение, состоящее из подробной структуры или строки.

Reason.Detailed

Структура, идентифицирующая локализуемый строковый ресурс для описания причины запроса на питание.

Reason.Detailed.LocalizedReasonModule

Модуль, содержащий строковый ресурс.

Reason.Detailed.LocalizedReasonId

Идентификатор строкового ресурса.

Reason.Detailed.ReasonStringCount

Количество строк в параметре ReasonStrings .

Reason.Detailed.ReasonStrings

Массив строк для замены в строковом ресурсе во время выполнения.

Reason.SimpleReasonString

Нелокализованная строка, описывающая причину запроса на питание.

Комментарии

Можно безопасно передавать строки, доступные только для чтения, как SimpleReasonString или ReasonStrings , так как функции PowerCreateRequest и SetWaitableTimerEx считывают из строк и не записывают их.

Требования

См. также раздел

PowerCreateRequest

SetWaitableTimerEx