通过

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

由 Detailed 结构或字符串组成的联合。

Reason.Detailed

一个 结构，它标识可本地化的字符串资源，用于描述电源请求的原因。

Reason.Detailed.LocalizedReasonModule

包含字符串资源的模块。

Reason.Detailed.LocalizedReasonId

字符串资源的 ID。

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