Fungsi RegisterForRuntimeStartup

Menjalankan panggilan balik ketika runtime .NET dimulai dalam proses yang ditentukan.

Sintaksis

HRESULT RegisterForRuntimeStartup (
    [in] DWORD dwProcessId,
    [in] PSTARTUP_CALLBACK pfnCallback,
    [in] PVOID parameter,
    [out] PVOID *ppUnregisterToken)
);

Parameter-parameternya

dwProcessId
[di] Id proses dari proses target.

pfnCallback
[di] Panggilan balik yang dipanggil saat runtime dimulai. Lihat PSTARTUP_CALLBACK penunjuk fungsi.

parameter
Penunjuk data [in] diteruskan ke pfnCallback.

ppUnregisterToken
[out] pointer untuk mengembalikan token UnregisterForRuntimeStartup .

Mengembalikan nilai

S_OK
Panggilan balik startup berhasil didaftarkan.

E_INVALIDARG
Baik pfnCallback atau ppUnregisterToken null.

E_FAIL (atau kode pengembalian lainnya E_ )
Pendaftaran panggilan balik gagal.

Komentar

Panggilan balik diteruskan instans ICorDebug yang tepat untuk versi runtime atau kesalahan jika ada yang gagal. API ini berfungsi untuk meluncurkan dan melampirkan (dan bahkan skenario lampirkan jika runtime belum dimuat) secara merata pada xplat dan Windows. Panggilan balik selalu dipanggil pada utas terpisah. API ini segera kembali. Panggilan balik dipanggil ketika modul runtime coreclr dimuat selama inisialisasi awal. Runtime diblokir selama inisialisasi hingga panggilan balik kembali. Jika runtime sudah dimuat dalam proses (seperti dalam kasus lampiran normal), panggilan balik dijalankan dan runtime tidak diblokir. Panggilan balik selalu dipanggil pada utas terpisah dan API ini segera kembali. Hanya instans modul coreclr pertama yang ditemukan dalam proses target yang saat ini didukung.

Persyaratan

Platform: Lihat Sistem operasi yang didukung .NET.

Header: dbgshim.h

Pustaka: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Versi .NET: Tersedia sejak .NET Core 2.1