EnumerateCLRs işlevi

Bir işlemde CLR'leri numaralandırmak için bir mekanizma sağlar.

Sözdizimi

HRESULT EnumerateCLRs (
    [in]  DWORD      debuggeePID,
    [out] HANDLE**   ppHandleArrayOut,
    [out] LPWSTR**   ppStringArrayOut,
    [out] DWORD*     pdwArrayLengthOut
);

Parametreler

debuggeePID
[in] Yüklenen CLR'lerin numaralandırılacağı işlemin işlem tanımlayıcısı.

ppHandleArrayOut
[out] CLR başlatmaya devam etmek için kullanılan olay tanıtıcılarını içeren bir dizi işaretçisi. Dizideki her tanıtıcının geçerli olacağı garanti değildir. Geçerliyse, tanıtıcı aynı dizininde ppStringArrayOutbulunan ilgili çalışma zamanı için continue-startup olayı olarak kullanılır.

ppStringArrayOut
[out] İşlemde yüklenen CLR'lerin tam yollarını belirten dize dizisinin işaretçisi.

pdwArrayLengthOut
[out] Eşit boyutlu ppHandleArrayOut ve pdwArrayLengthOutuzunluğunu içeren bir DWORD işaretçisi.

Dönüş değeri

S_OK
İşlemdeki CLR sayısı başarıyla belirlendi ve karşılık gelen tanıtıcı ve yol dizileri düzgün bir şekilde dolduruldu.

E_INVALIDARG
ya da ppHandleArrayOutppStringArrayOut null veya pdwArrayLengthOut null.

E_OUTOFMEMORY
İşlev, tanıtıcı ve yol dizileri için yeterli bellek ayıramıyor.

E_FAIL (veya diğer E_ iade kodları)
Yüklü CLR'ler numaralandırılamıyor.

Açıklamalar

tarafından debuggeePIDtanımlanan bir hedef işlem için işlev, ppStringArrayOutişlemde yüklenen CLR'lere bir yol dizisi, aynı dizindeki CLR için bir continue-startup olayı içerebilen bir olay tutamaçları ppHandleArrayOutdizisi ve yüklenen CLR sayısını belirten dizilerin pdwArrayLengthOutboyutunu döndürür.

Windows işletim sisteminde bir debuggeePID işletim sistemi işlem tanımlayıcısına eşler.

ve ppHandleArrayOut için ppStringArrayOut bellek bu işlev tarafından ayrılır. Ayrılan belleği boşaltmak için CloseCLREnumeration İşlevini çağırmanız gerekir.

Bu işlev, hedef işlemdeki CLR sayısını döndürmek için her iki dizi parametresi null olarak ayarlandığında çağrılabilir. Bu sayıdan, çağıran oluşturulacak arabellek boyutunu çıkarsayabilirsiniz: (sizeof(HANDLE) * count) + (sizeof(LPWSTR) * count) + (sizeof(WCHAR*) * count * MAX_PATH).

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