EnumerateCLRs függvény

Mechanizmust biztosít a CLR-ek számbavételéhez egy folyamatban.

Szemantika

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

Paraméterek

debuggeePID
[in] Annak a folyamatnak a folyamatazonosítója, amelyből a rendszer számba veszi a betöltött CLR-eket.

ppHandleArrayOut
[kifelé] Mutasson egy olyan tömbre, amely a CLR-indítás folytatásához használt eseményfogópontokat tartalmazza. A tömb minden fogópontja nem garantáltan érvényes. Ha érvényes, akkor a leírót kell használni a megfelelő futtatókörnyezet indítási eseményeként, amely ugyanabban az indexben ppStringArrayOuttalálható.

ppStringArrayOut
[kifelé] Mutasson egy sztringtömbre, amely a folyamatban betöltött CLR-ek teljes elérési útját adja meg.

pdwArrayLengthOut
[kifelé] Mutasson egy olyan DWORD-ra, amely az egyenlő méretű ppHandleArrayOut és pdwArrayLengthOuta .

Visszaadott érték

S_OK
A folyamat CLR-jeinek száma sikeresen meghatározva lett, és a megfelelő leíró- és elérésiút-tömbök megfelelően lettek kitöltve.

E_INVALIDARG
ppHandleArrayOut Vagy ppStringArrayOut null, vagy pdwArrayLengthOut null értékű.

E_OUTOFMEMORY
A függvény nem tud elegendő memóriát lefoglalni a leíró- és elérésiút-tömbök számára.

E_FAIL (vagy egyéb E_ visszatérési kódok)
A betöltött CLR-ek számbavétele nem sikerült.

Megjegyzések

Az azonosított debuggeePIDcélfolyamatok esetében a függvény egy elérési út tömböt ad vissza, ppStringArrayOuta folyamatba betöltött CLR-eknek; egy eseményfogópont-tömböt, ppHandleArrayOutamely ugyanahhoz az indexhez tartozó clr indítási eseményt tartalmazhat, valamint a tömbök méretét, pdwArrayLengthOutamely a betöltött CLR-ek számát határozza meg.

A Windows operációs rendszeren debuggeePID leképez egy operációsrendszer-folyamatazonosítót.

A függvény által ppHandleArrayOut lefoglalt memória ppStringArrayOut . A lefoglalt memória felszabadításához meg kell hívnia a CloseCLREnumeration függvényt.

Ez a függvény meghívható úgy, hogy mindkét tömbparaméter null értékűre van állítva a célfolyamat CLR-jeinek számának visszaadásához. Ebből a számból a hívó a létrehozandó puffer méretét tudja kikövetkeztetni: (sizeof(HANDLE) * count) + (sizeof(LPWSTR) * count) + (sizeof(WCHAR*) * count * MAX_PATH).

Követelmények

Platformok: Lásd: .NET által támogatott operációs rendszerek.

Fejléc: dbgshim.h

Könyvtár: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET-verziók: A .NET Core 2.1 óta érhető el