struktur COUNTED_REASON_CONTEXT (ntpoapi.h)

Struktur COUNTED_REASON_CONTEXT berisi satu atau beberapa string yang memberikan alasan untuk permintaan daya.

Sintaks

typedef struct _COUNTED_REASON_CONTEXT {
  ULONG Version;
  ULONG Flags;
  union {
    struct {
      UNICODE_STRING  ResourceFileName;
      USHORT          ResourceReasonId;
      ULONG           StringCount;
      PUNICODE_STRING ReasonStrings;
    } DUMMYSTRUCTNAME;
    UNICODE_STRING SimpleString;
  } DUMMYUNIONNAME;
} COUNTED_REASON_CONTEXT, *PCOUNTED_REASON_CONTEXT;

Anggota

Version

Nomor versi struktur. Atur anggota ini ke DIAGNOSTIC_REASON_VERSION.

Flags

Menunjukkan apakah struktur berisi string alasan sederhana atau serangkaian string alasan terperinci. Atur anggota ini ke salah satu konstanta berikut:

• DIAGNOSTIC_REASON_SIMPLE_STRING
• DIAGNOSTIC_REASON_DETAILED_STRING

Jika Bendera = DIAGNOSTIC_REASON_SIMPLE_STRING, anggota SimpleString dari serikat tersebut valid. Jika Bendera = DIAGNOSTIC_REASON_DETAILED_STRING, anggota ResourceFileName, ResourceReasonId, StringCount, dan ReasonStrings valid (dan anggota SimpleString tidak valid).

DUMMYUNIONNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceFileName

Penunjuk ke string berkarakter lebar dan dihentikan null yang berisi nama jalur file sumber daya. File sumber daya ini berisi satu atau beberapa string yang dilokalkan yang memberikan alasan untuk permintaan daya. Anggota ini bersifat opsional dan dapat ditentukan sebagai NULL atau sebagai string kosong jika tidak ada file sumber daya yang diperlukan. Anggota ini hanya valid jika Bendera = DIAGNOSTIC_REASON_DETAILED_STRING.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceReasonId

ID sumber daya yang ditetapkan ke string alasan pertama dalam file sumber daya yang ditentukan oleh ResourceFileName. Anggota ini hanya valid jika Bendera = DIAGNOSTIC_REASON_DETAILED_STRING.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.StringCount

Jumlah string alasan dalam array ReasonStrings atau dalam file sumber daya yang ditentukan oleh ResourceFileName. Anggota ini hanya valid jika Bendera = DIAGNOSTIC_REASON_DETAILED_STRING.

DUMMYUNIONNAME.DUMMYSTRUCTNAME.ReasonStrings

Penunjuk ke array penunjuk string. Setiap elemen array adalah penunjuk ke string yang dihentikan dengan karakter lebar dan null. Jumlah elemen array ditentukan oleh StringCount. Anggota ini hanya valid jika Bendera = DIAGNOSTIC_REASON_DETAILED_STRING.

DUMMYUNIONNAME.SimpleString

Penunjuk ke string berkarakter lebar dan dihentikan null yang menjelaskan alasan permintaan daya. Anggota ini hanya valid jika Bendera = DIAGNOSTIC_REASON_SIMPLE_STRING.

Keterangan

Struktur ini digunakan oleh rutinitas PoCreatePowerRequest .

Manajer daya menggunakan string alasan atau string yang terkandung dalam struktur ini sebagai bantuan diagnostik selama pengujian fungsional dan performa.

Struktur COUNTED_REASON_CONTEXT dapat berisi string alasan sederhana atau serangkaian string alasan terperinci. Jika Bendera = DIAGNOSTIC_REASON_SIMPLE_STRING, anggota SimpleString menunjuk ke string yang menjelaskan alasan permintaan daya. Jika Bendera = DIAGNOSTIC_REASON_DETAILED_STRING, anggota ResourceFileName, ResourceReasonId, StringCount, dan ReasonStrings dapat memberikan serangkaian alasan terperinci untuk permintaan daya.

Bendera DIAGNOSTIC_REASON_DETAILED_STRING mendukung pelokalan. Jika file sumber daya yang dilokalkan yang ditentukan oleh ResourceFileName ada, manajer daya mengambil string sumber daya yang ditentukan oleh ResourceReasonId dari file lalu memformat string, mengganti %1, , %2dll. tempat penampung dengan item yang sesuai dari array ReasonStrings . Penentu format lain yang digunakan dengan FormatMessageW tidak didukung.

Manajer daya mengambil string sumber daya dari sumber daya STRINGTABLE.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di Windows 7 dan versi yang lebih baru dari sistem operasi Windows.
Header	ntpoapi.h (termasuk Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h)

Lihat juga

PoCreatePowerRequest