Fungsi RegisterForRuntimeStartup3

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

Sintaksis

HRESULT RegisterForRuntimeStartup3 (
    [in] DWORD dwProcessId,
    [in] LPCWSTR lpApplicationGroupId,
    [in] ICLRDebuggingLibraryProvider3* pLibraryProvider,
    [in] PSTARTUP_CALLBACK pfnCallback,
    [in] PVOID parameter,
    [out] PVOID *ppUnregisterToken)
);

Parameter-parameternya

dwProcessId
[di] Id proses dari proses target.

lpApplicationGroupId
[di] String yang mewakili ID grup aplikasi dari proses terkotakpasir yang berjalan di Mac. Berikan NULL jika proses tidak berjalan di kotak pasir dan platform lainnya.

pLibraryProvider
[di] Instans antarmuka panggilan balik untuk menemukan DBI dan DAC. Lihat Antarmuka ICLRDebuggingLibraryProvider3 .

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.

Ini adalah satu-satunya fungsi register yang berfungsi untuk aplikasi file tunggal.

Persyaratan

Platform: Lihat Sistem operasi yang didukung .NET.

Header: dbgshim.h

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

Versi .NET: Tersedia sejak .NET 6.0