RegisterForRuntimeStartup işlevi

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

Sözdizimi

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

Parametreler

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

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 öğesine pfnCallbackgeç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.

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 Core 2.1'den itibaren kullanılabilir