IDebugControl3::GetTextReplacement method (dbgeng.h)

Artikel
02/23/2024

Metode GetTextReplacement mengembalikan nilai alias bernama pengguna atau alias otomatis.

Sintaks

HRESULT GetTextReplacement(
  [in, optional]  PCSTR  SrcText,
  [in]            ULONG  Index,
  [out, optional] PSTR   SrcBuffer,
  [in]            ULONG  SrcBufferSize,
  [out, optional] PULONG SrcSize,
  [out, optional] PSTR   DstBuffer,
  [in]            ULONG  DstBufferSize,
  [out, optional] PULONG DstSize
);

Parameter

[in, optional] SrcText

Menentukan nama alias. Mesin pertama-tama mencari alias bernama pengguna dengan nama ini. Kemudian, jika tidak ada kecocokan yang ditemukan, alias otomatis akan dicari. Jika SrcTextNULL, Indeks digunakan untuk menentukan alias.

[in] Index

Menentukan indeks alias. Indeks alias bernama pengguna datang sebelum indeks alias otomatis. Indeks hanya digunakan jika SrcText adalah NULL. Indeks dapat digunakan bersama dengan GetNumberTextReplacements untuk melakukan iterasi di semua alias bernama pengguna dan otomatis.

[out, optional] SrcBuffer

Menerima nama alias. Ini adalah nama yang ditentukan dalam SrcText, jika SrcText bukan NULL. Jika SrcBufferNULL, informasi ini tidak dikembalikan.

[in] SrcBufferSize

Menentukan ukuran, dalam karakter, dari buffer SrcBuffer .

[out, optional] SrcSize

Menerima ukuran, dalam karakter, dari nama alias. Jika SrcSizeNULL, informasi ini tidak dikembalikan.

[out, optional] DstBuffer

Menerima nilai alias yang ditentukan oleh SrcText dan Indeks. Jika DstBufferNULL, informasi ini tidak dikembalikan.

[in] DstBufferSize

Menentukan ukuran, dalam karakter, dari buffer DstBuffer .

[out, optional] DstSize

Menerima ukuran, dalam karakter, dari nilai alias. Jika DstSizeNULL, 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.

Keterangan

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

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.