Metode IDebugControl3::GetExtensionFunction (dbgeng.h)

Artikel
02/26/2024

Metode GetExtensionFunction mengembalikan pointer ke fungsi ekstensi dari pustaka ekstensi.

Sintaks

HRESULT GetExtensionFunction(
  [in]  ULONG64 Handle,
  [in]  PCSTR   FuncName,
  [out] FARPROC *Function
);

Parameter

[in] Handle

Menentukan handel pustaka ekstensi yang berisi fungsi ekstensi. Jika Handle adalah nol, mesin akan berjalan rantai pustaka ekstensi mencari fungsi ekstensi.

[in] FuncName

Menentukan nama fungsi ekstensi yang akan dikembalikan. Saat mencari pustaka ekstensi untuk fungsi tersebut, mesin debugger akan menambahkan "EFN" ke nama. Misalnya, jika FuncName adalah "SampleFunction", mesin akan mencari pustaka ekstensi untuk "_EFN_SampleFunction".

[out] Function

Menerima fungsi ekstensi.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Pustaka ekstensi dimuat ke dalam mesin host dan fungsi ekstensi tidak dapat dipanggil dari jarak jauh. Klien saat ini tidak boleh menjadi klien debugging, itu harus milik mesin host.

Fungsi ekstensi dapat memiliki prototipe fungsi apa pun. Agar setiap program memanggil fungsi ekstensi ini, fungsi ekstensi harus ditransmisikan ke prototipe yang benar.

Untuk informasi selengkapnya tentang menggunakan fungsi ekstensi, lihat Ekstensi Panggilan dan Fungsi Ekstensi.