Metode IDebugAdvanced3::GetSourceFileInformation (dbgeng.h)

Artikel
03/08/2023

Metode GetSourceFileInformation mengembalikan informasi tertentu tentang file sumber.

Sintaks

HRESULT GetSourceFileInformation(
  [in]            ULONG   Which,
  [in]            PSTR    SourceFile,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize
);

Parameter

[in] Which

Menentukan bagian informasi yang akan dikembalikan. Parameter Mana yang dapat mengambil salah satu nilai dalam tabel berikut.

DEBUG_SRCFILE_SYMBOL_TOKEN

Mengembalikan token yang mewakili file sumber yang ditentukan pada server sumber. Token ini dapat diteruskan ke FindSourceFileAndToken untuk mengambil informasi tentang file. Token dikembalikan ke buffer Buffer sebagai array byte. Ukuran token ini adalah cerminan dari ukuran token SrcSrv.

DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE

Mengkueri server sumber untuk perintah untuk mengekstrak file sumber dari kontrol sumber. Ini termasuk nama file yang dapat dieksekusi dan parameter baris perintahnya. Perintah dikembalikan ke buffer Buffer sebagai string Unicode.

[in] SourceFile

Menentukan file sumber yang informasinya sedang diminta. File sumber dicari di semua server sumber di jalur sumber.

[in] Arg64

Menentukan argumen 64-bit. Nilai Yang menentukan modul yang token simbolnya diminta. Terlepas dari nilai yang, Arg64 adalah lokasi dalam alokasi memori modul.

[in] Arg32

Menentukan argumen 32-bit. Parameter ini saat ini tidak digunakan.

[out, optional] Buffer

Menerima informasi simbol yang diminta. Jenis data yang dikembalikan tergantung pada nilai Yang. Jika BufferNULL, informasi ini tidak dikembalikan.

[in] BufferSize

Menentukan ukuran dalam byte buffer Buffer . Jika BufferNULL, BufferSize juga harus NULL.

[out, optional] InfoSize

Menentukan ukuran dalam byte informasi yang dikembalikan ke buffer Buffer . Parameter ini bisa NULL jika data tidak diperlukan.

Menampilkan nilai

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, informasi tidak akan cocok di buffer Buffer , sehingga informasi atau nama terpotong.

Keterangan

Untuk informasi selengkapnya tentang file sumber, lihat Menggunakan File Sumber.

Persyaratan

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

Lihat juga

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3

Share via