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

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

Reason.Detailed.ReasonStringCount

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

Reason.Detailed.ReasonStrings

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

Reason.SimpleReasonString

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

설명

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글 minwinbase.h(Windows.h 포함)

추가 정보

PowerCreateRequest

SetWaitableTimerEx