RegisterForRuntimeStartup3 işlevi

Belirtilen işlemde .NET çalışma zamanı başlatıldığında geri çağırmayı yürütür.

Sözdizimi

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

Parametreler

dwProcessId
[in] Hedef işlemin işlem kimliği.

lpApplicationGroupId
[in] Mac'te çalışan korumalı bir işlemin uygulama grubu kimliğini temsil eden dize. İşlem bir korumalı alanda ve diğer platformlarda çalışmıyorsa NULL değerini geçirin.

pLibraryProvider
[in] DBI ve DAC'nin yerini bulmak için bir geri çağırma arabirimi örneği. Bkz. ICLRDebuggingLibraryProvider3 arabirimi.

pfnCallback
[in] Çalışma zamanı başlatıldığında çağrılan bir geri çağırma. bkz. PSTARTUP_CALLBACK işlev işaretçisi.

parameter
[in] veri işaretçisi pfnCallback'e geçirildi.

ppUnregisterToken
UnregisterForRuntimeStartup belirtecini döndüren [out] işaretçisi.

Dönüş değeri

S_OK
Başlangıç geri çağırması başarıyla kaydedildi.

E_INVALIDARG
veya pfnCallbackppUnregisterToken null.

E_FAIL (veya diğer E_ iade kodları)
Geri çağırma kaydı başarısız oldu.

Açıklamalar

Geri çağırma, çalışma zamanının sürümü için uygun ICorDebug örneğine veya bir hata başarısız olursa bir hataya geçirilir. Bu API hem xplat hem de Windows üzerinde başlatma ve ekleme (ve çalışma zamanı henüz yüklenmediyse ekleme senaryosu) için de çalışır. Geri çağırma her zaman ayrı bir iş parçacığında çağrılır. Bu API hemen döndürür. Erken başlatma sırasında coreclr çalışma zamanı modülü yüklendiğinde geri çağırma çağrılır. Geri çağırma dönene kadar başlatma sırasında çalışma zamanı engellenir. Çalışma zamanı işlemde zaten yüklüyse (normal ekleme durumunda olduğu gibi), geri çağırma yürütülür ve çalışma zamanı engellenmez. Geri çağırma her zaman ayrı bir iş parçacığında çağrılır ve bu API hemen döndürür. Şu anda yalnızca hedef işlemde bulunan ilk coreclr modülü örneği desteklenmektedir.

Bu, tek dosyalı uygulamalar için çalışan tek yazmaç işlevidir.

Gereksinimler

Platform: Bkz. .NET tarafından desteklenen işletim sistemleri.

Üst bilgi: dbgshim.h

Kitaplık: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET Sürümleri: .NET 6.0'dan itibaren kullanılabilir