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

문자열 리소스의 ID입니다.

Reason.Detailed.ReasonStringCount

ReasonStrings 매개 변수의 문자열 수입니다.

Reason.Detailed.ReasonStrings

런타임에 문자열 리소스에서 대체될 문자열 배열입니다.

Reason.SimpleReasonString

전원 요청의 이유를 설명하는 지역화되지 않은 문자열입니다.

설명

PowerCreateRequest 및 SetWaitableTimerEx 함수는 문자열에서 읽고 쓰지 않으므로 읽기 전용 문자열을 SimpleReasonString 또는 ReasonStrings로 전달하는 것이 안전합니다.

요구 사항

추가 정보

PowerCreateRequest

SetWaitableTimerEx