Share via

структура 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

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

Значение Значение
POWER_REQUEST_CONTEXT_DETAILED_STRING
0x00000002
 Подробная структура определяет локализуемый строковый ресурс, описывающий причину запроса на питание.
POWER_REQUEST_CONTEXT_SIMPLE_STRING
0x00000001
 Параметр SimpleReasonString содержит простую, не локализуемую строку, которая описывает причину запроса на питание.

Reason

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

Reason.Detailed

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

Reason.Detailed.LocalizedReasonModule

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

Reason.Detailed.LocalizedReasonId

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

Reason.Detailed.ReasonStringCount

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

Reason.Detailed.ReasonStrings

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

Reason.SimpleReasonString

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

Комментарии

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

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Верхняя часть minwinbase.h (включая Windows.h)

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

PowerCreateRequest

SetWaitableTimerEx