Metode IDebugControl2::SetTextReplacement (dbgeng.h)

Artikel
02/23/2024

Metode SetTextReplacement menetapkan nilai alias bernama pengguna.

Sintaks

HRESULT SetTextReplacement(
  [in]           PCSTR SrcText,
  [in, optional] PCSTR DstText
);

Parameter

[in] SrcText

Menentukan nama alias bernama pengguna. Mesin debugger membuat salinan string ini. Jika SrcText sama dengan nama alias otomatis, alias otomatis disembunyikan oleh alias bernama pengguna baru.

[in, optional] DstText

Menentukan nilai alias bernama pengguna. Mesin debugger membuat salinan string ini. Jika DstText adalah NULL, alias bernama pengguna akan dihapus.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Sebelum menjalankan perintah atau mengevaluasi ekspresi, mesin debugger akan menggantikan alias yang ditentukan oleh SrcText dengan nilai alias (ditentukan oleh DstText).

Jika SrcText adalah tanda bintang (*) dan DstText adalah NULL, semua alias bernama pengguna akan dihapus. Ini adalah perilaku yang sama dengan metode RemoveTextReplacements .

Ketika alias diubah oleh metode ini, panggilan balik peristiwa diberi tahu dengan meneruskan bendera DEBUG_CES_TEXT_REPLACEMENTS ke metode panggilan balik IDebugEventCallbacks::ChangeEngineState .

Untuk gambaran umum alias yang digunakan oleh mesin debugger, lihat Menggunakan Alias. Untuk informasi selengkapnya tentang menggunakan alias dengan API mesin debugger, lihat Berinteraksi dengan Mesin.