EnumerateCLRs, functie

Biedt een mechanisme voor het inventariseren van de CLR's in een proces.

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

debuggeePID
[in] Proces-id van het proces waaruit geladen CDR's worden geïnventariseerd.

ppHandleArrayOut
[uit] Aanwijzer naar een matrix met gebeurtenisingangen die worden gebruikt om een CLR-opstartproces voort te zetten. Elke ingang in de matrix is niet gegarandeerd geldig. Indien geldig, moet de ingang worden gebruikt als de continue opstartgebeurtenis voor de bijbehorende runtime die zich in dezelfde index bevindt ppStringArrayOut.

ppStringArrayOut
[uit] Wijs een matrix met tekenreeksen aan waarmee volledige paden naar CDR's worden opgegeven die in het proces zijn geladen.

pdwArrayLengthOut
[uit] Wijs een DWORD aan die de lengte van de gelijke grootte ppHandleArrayOut en pdwArrayLengthOut.

S_OK
Het aantal CDR's in het proces is bepaald en de bijbehorende ingang en padmatrices zijn correct ingevuld.

E_INVALIDARG
Of ppHandleArrayOut is null, ppStringArrayOut of pdwArrayLengthOut is null.

E_OUTOFMEMORY
De functie kan onvoldoende geheugen toewijzen voor de handle- en padmatrices.

E_FAIL (of andere E_ retourcodes)
Kan geladen CLR's niet inventariseren.

Voor een doelproces dat wordt geïdentificeerd door debuggeePID, retourneert de functie een matrix van paden, ppStringArrayOutnaar CDR's die in het proces zijn geladen; een matrix met gebeurtenis-ingangen, ppHandleArrayOutdie een continue opstartgebeurtenis voor de CLR in dezelfde index kan bevatten; en de grootte van de matrices, pdwArrayLengthOutwaarmee het aantal CDR's wordt opgegeven dat wordt geladen.

Wijst op het Windows-besturingssysteem debuggeePID toe aan een proces-id van het besturingssysteem.

Het geheugen voor ppHandleArrayOut en ppStringArrayOut worden toegewezen door deze functie. Als u het toegewezen geheugen wilt vrij maken, moet u De functie CloseCLREnumeration aanroepen.

Deze functie kan worden aangeroepen met beide matrixparameters ingesteld op null om het aantal CDR's in het doelproces te retourneren. Op basis van dit aantal kan een beller de grootte van de buffer afleiden die wordt gemaakt: (sizeof(HANDLE) * count) + (sizeof(LPWSTR) * count) + (sizeof(WCHAR*) * count * MAX_PATH).

Platforms: Zie ondersteunde besturingssystemen van .NET.

Koptekst: dbgshim.h

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

.NET-versies: beschikbaar sinds .NET Core 2.1