Metode IDataModelScriptDebug::GetCurrentPosition (dbgmodel.h)
Metode GetCurrentPosition mengembalikan posisi saat ini dalam skrip. Ini mungkin hanya dipanggil ketika skrip dipecah menjadi debugger di mana panggilan ke GetScriptState akan mengembalikan ScriptDebugBreak. Panggilan lain ke metode ini tidak valid dan akan gagal.
Posisi skrip didefinisikan sebagai rentang karakter. Awal rentang harus selalu dikembalikan (nomor baris dan kolom). Jika debugger tertentu mampu mengembalikan rentang penuh "posisi saat ini" dalam skrip, posisi akhir secara opsional dapat dikembalikan dalam argumen positionSpanEnd. Jika debugger tidak mampu melakukan ini, nilai baris dan kolom dalam rentang akhir (jika diminta) harus diatur ke nol.
Jika debugger dapat meneruskan kode sumber untuk baris kode tempat debugger rusak, debugger dapat mengembalikannya dari metode ini. Jika memungkinkan, sangat dianjurkan untuk memberikan informasi ini. Namun, tidak ada persyaratan bahwa informasi lebih lanjut daripada baris awal dan kolom posisi jeda dikembalikan. Jika informasi baris sumber tidak didukung, nilai nullptr dapat dikembalikan untuk argumen tersebut.
Sintaks
HRESULT GetCurrentPosition(
ScriptDebugPosition *currentPosition,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parameter
currentPosition
Posisi jeda skrip saat ini harus dikembalikan di sini. Bidang Garis dan Kolom dari struktur yang dikembalikan adalah satu berbasis. Nilai nol dalam keduanya menunjukkan bahwa informasi tidak tersedia.
positionSpanEnd
Jika debugger mampu menentukan rentang penuh posisi jeda, posisi akhir rentang dapat dikembalikan di sini. Jika tidak, nilai nol harus diisi ke dalam bidang Baris dan Kolom dari struktur yang dikembalikan.
lineText
Jika debugger mampu mengembalikan kode sumber untuk baris (atau rentang) pemisah, hal tersebut dapat dikembalikan di sini sebagai string yang dialokasikan oleh fungsi SysAllocString. Pemanggil bertanggung jawab untuk membebaskan string yang dikembalikan dengan SysFreeString. Jika debugger tidak mampu menghasilkan informasi sumber ini, nullptr harus dikembalikan.
Mengembalikan nilai
Metode ini mengembalikan HRESULT yang menunjukkan keberhasilan atau kegagalan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | dbgmodel.h |