struktur REASON_CONTEXT (minwinbase.h)

Artikel
02/29/2024

Berisi informasi tentang permintaan daya. Struktur ini digunakan oleh fungsi PowerCreateRequest dan SetWaitableTimerEx .

Sintaks

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;

Anggota

Version

Nomor versi struktur. Parameter ini harus diatur ke POWER_REQUEST_CONTEXT_VERSION.

Flags

Format alasan permintaan daya. Parameter ini bisa menjadi salah satu nilai berikut:

Nilai	Makna
POWER_REQUEST_CONTEXT_DETAILED_STRING 0x00000002	Struktur Terperinci mengidentifikasi sumber daya string yang dapat dilokalkan yang menjelaskan alasan permintaan daya.
POWER_REQUEST_CONTEXT_SIMPLE_STRING 0x00000001	Parameter SimpleReasonString berisi string sederhana dan tidak dapat dilokalkan yang menjelaskan alasan permintaan daya.

Reason

Serikat yang terdiri dari struktur Terperinci atau string.

Reason.Detailed

Struktur yang mengidentifikasi sumber daya string yang dapat dilokalkan untuk menjelaskan alasan permintaan daya.

Reason.Detailed.LocalizedReasonModule

Modul yang berisi sumber daya string.

Reason.Detailed.LocalizedReasonId

ID sumber daya string.

Reason.Detailed.ReasonStringCount

Jumlah string dalam parameter ReasonStrings .

Reason.Detailed.ReasonStrings

Array string yang akan diganti dalam sumber daya string pada durasi.

Reason.SimpleReasonString

String yang tidak dilokalkan yang menjelaskan alasan permintaan daya.

Keterangan

Aman untuk meneruskan string baca-saja sebagai SimpleReasonString atau ReasonStrings karena fungsi PowerCreateRequest dan SetWaitableTimerEx dibaca dari string dan tidak menulisnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Header	minwinbase.h (termasuk Windows.h)

Lihat juga

PowerCreateRequest

SetWaitableTimerEx