Metode IDataModelScriptDebugBreakpoint::GetPosition (dbgmodel.h)

Metode GetPosition mengembalikan posisi titik henti dalam skrip. Debugger skrip harus mengembalikan baris dan kolom dalam kode sumber tempat titik henti berada. Jika mampu melakukannya, itu juga dapat mengembalikan rentang sumber yang diwakili oleh titik henti dengan mengisi posisi akhir seperti yang didefinisikan oleh argumen positionSpanEnd. Jika debugger tidak mampu menghasilkan rentang ini dan pemanggil memintanya, bidang Baris dan Kolom dari posisi akhir rentang harus diisi sebagai nol yang menunjukkan bahwa nilai tidak dapat disediakan.

Debugger juga dapat mengembalikan teks baris (atau rentang) kode sumber di mana titik henti ada dalam argumen lineText. Meskipun sangat disarankan agar debugger mengembalikan nilai ini, itu tidak diperlukan. Hanya posisi baris dan kolom dalam sumber yang diperlukan nilai pengembalian. Jika debugger tidak mampu menghasilkan teks sumber, nullptr dapat dikembalikan dalam argumen lineText.

Sintaks

HRESULT GetPosition(
  ScriptDebugPosition *position,
  ScriptDebugPosition *positionSpanEnd,
  BSTR                *lineText
);

Parameter

position

Posisi baris dan kolom titik henti dalam kode sumber skrip harus dikembalikan di sini.

positionSpanEnd

Jika debugger mampu menghasilkan rentang sumber yang diwakili oleh titik henti, debugger dapat mengembalikan posisi baris dan kolom dari akhir rentang di sini. Jika tidak, nilai Garis dan Kolom struktur harus diatur ke nol yang menunjukkan bahwa nilai tidak dapat disediakan..

lineText

Jika debugger dapat menghasilkan baris (atau rentang) kode sumber yang diwakili oleh titik henti, debugger akan kembali seperti string yang dialokasikan melalui fungsi SysAllocString. Pemanggil bertanggung jawab untuk membebaskan string yang dikembalikan melalui SysFreeString. Jika debugger tidak mampu mengembalikan teks sumber ini, nullptr harus dikembalikan di sini.

Mengembalikan nilai

Metode ini mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan.

Persyaratan

Persyaratan Nilai
Header dbgmodel.h

Lihat juga

Antarmuka IDataModelScriptDebugBreakpoint