Metode IDebugControl4::GetLastEventInformationWide (dbgeng.h)

Artikel
02/23/2024

Metode GetLastEventInformationWide mengembalikan informasi tentang peristiwa terakhir yang terjadi dalam target.

Sintaks

HRESULT GetLastEventInformationWide(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed,
  [out, optional] PWSTR  Description,
  [in]            ULONG  DescriptionSize,
  [out, optional] PULONG DescriptionUsed
);

Parameter

[out] Type

Menerima jenis peristiwa terakhir yang dihasilkan oleh target. Untuk daftar jenis yang mungkin, lihat DEBUG_EVENT_XXX.

[out] ProcessId

Menerima ID proses dari proses di mana peristiwa terjadi. Jika informasi ini tidak tersedia, DEBUG_ANY_ID akan dikembalikan sebagai gantinya.

[out] ThreadId

Menerima ID utas utas tempat peristiwa terakhir terjadi. Jika informasi ini tidak tersedia, DEBUG_ANY_ID akan dikembalikan sebagai gantinya.

[out, optional] ExtraInformation

Menerima informasi tambahan tentang peristiwa tersebut. Konten informasi tambahan ini tergantung pada jenis peristiwa seperti yang ditunjukkan oleh parameter Jenis yang dikembalikan. Misalnya, jika Jenis adalah titik henti, ExtraInformation berisi DEBUG_LAST_EVENT_INFO_BREAKPOINT; jika Jenis adalah Pengecualian, ExtraInformation berisi DEBUG_LAST_EVENT_INFO_EXCEPTION. Lihat DEBUG_EVENT_XXX untuk daftar lengkap jenis peristiwa dan file header dbgeng.h untuk definisi struktur untuk setiap jenis peristiwa.

Jika ExtraInformationADALAH NULL, informasi ini tidak dikembalikan.

[in] ExtraInformationSize

Menentukan ukuran, dalam byte, dari buffer yang ditentukan ExtraInformation .

[out, optional] ExtraInformationUsed

Menerima ukuran, dalam byte, informasi tambahan. Jika ExtraInformationUsed adalah NULL, informasi ini tidak dikembalikan.

[out, optional] Description

Menerima deskripsi peristiwa. Jika DeskripsiNULL, informasi ini tidak dikembalikan.

[in] DescriptionSize

Menentukan ukuran, dalam karakter, dari buffer yang ditentukan Deskripsi . Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri.

[out, optional] DescriptionUsed

Menerima ukuran dalam karakter deskripsi peristiwa. Ukuran ini mencakup ruang untuk karakter '\0' yang mengakhiri. Jika DescriptionUsed adalah NULL, informasi ini tidak dikembalikan.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
S_FALSE	Metode berhasil. Namun, ExtraInformationSize atau DescriptionSize lebih kecil sehingga ukuran data atau untai (karakter) masing-masing dan data atau string dipotok agar pas di dalam buffer.

Keterangan

Untuk peristiwa pembuatan utas dan proses, ID utas dan ID proses yang dikembalikan ke ThreadId dan ProcessId adalah untuk utas atau proses yang baru dibuat.

Untuk informasi selengkapnya tentang peristiwa terakhir, lihat topik Informasi Peristiwa.

Persyaratan

Persyaratan	Nilai
Target Platform	Desktop
Header	dbgeng.h (termasuk Dbgeng.h)

Lihat juga

GetStoredEventInformation

IDebugControl4