Metode IDebugControl3::GetLastEventInformation (dbgeng.h)

Artikel
02/23/2024

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

Sintaks

HRESULT GetLastEventInformation(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed,
  [out, optional] PSTR   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 indeks utas (bukan ID utas) dari 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. Isi informasi tambahan ini tergantung pada jenis peristiwa. Jika ExtraInformationNULL, 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 ExtraInformationUsedADALAH 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 yang mengakhiri '\0'.

[out, optional] DescriptionUsed

Menerima ukuran dalam karakter deskripsi peristiwa. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'. 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 string masing-masing dan data atau string dipotong agar pas di dalam buffer.

Keterangan

Untuk peristiwa pembuatan utas dan proses, indeks 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.