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