共用方式為

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