Función EnumerateCLRs

Artículo
09/22/2023

Proporciona un mecanismo para enumerar los CLR de un proceso.

Sintaxis

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

Parámetros

debuggeePID
[in] Identificador del proceso desde el que se van a enumerar los CLR cargados.

ppHandleArrayOut
[out] Puntero a una matriz que contiene identificadores de evento que se usan para continuar el inicio de un CLR. No se garantiza que todos los identificadores de la matriz sean válidos. Si es válido, el identificador se usará como evento de inicio continuo para el tiempo de ejecución correspondiente ubicado en el mismo índice de ppStringArrayOut.

ppStringArrayOut
[out] Puntero a una matriz de cadenas que especifican las rutas de acceso completas a los CLR cargados en el proceso.

pdwArrayLengthOut
[out] Puntero a una DWORD que contiene la longitud de ppHandleArrayOut y pdwArrayLengthOut de igual tamaño.

Valor devuelto

S_OK
Se determinó el número de CLR en el proceso y las matrices de rutas de acceso e identificadores correspondientes se rellenaron correctamente.

E_INVALIDARG
ppHandleArrayOut o ppStringArrayOut es NULL, o pdwArrayLengthOut es NULL.

E_OUTOFMEMORY
La función no puede asignar suficiente memoria para las matrices de identificadores y rutas de acceso.

E_FAIL (u otros códigos de retorno E_)
No se pueden enumerar los CLR cargados.

Comentarios

Para un proceso de destino identificado por debuggeePID, la función devuelve una matriz de rutas de acceso, ppStringArrayOut, a los CLR cargados en el proceso; una matriz de identificadores de eventos, ppHandleArrayOut, que puede contener un evento de inicio continuo para el CLR en el mismo índice; y el tamaño de las matrices, pdwArrayLengthOut, que especifica el número de CLR que hay cargados.

En el sistema operativo Windows, debuggeePID se asigna a un identificador de procesos del sistema operativo.

Esta función asigna la memoria para ppHandleArrayOut y ppStringArrayOut. Para liberar la memoria asignada, se debe llamar a la función CloseCLREnumeration.

Se puede llamar a esta función con ambos parámetros de matriz establecidos en NULL para devolver el número de los CLR en el proceso de destino. A partir de este número, un llamador puede deducir el tamaño del búfer que se creará: (sizeof(HANDLE) * count) + (sizeof(LPWSTR) * count) + (sizeof(WCHAR*) * count * MAX_PATH).

Requisitos

Plataformas: consulte Sistemas operativos compatibles con .NET.

Encabezado: dbgshim.h

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

Versiones de .NET: disponible a partir de .NET Core 2.1

Compartir vía