Função EnumerateCLRs

Artigo
10/04/2023

Fornece um mecanismo para enumerar os CLRs em um processo.

Sintaxe

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

Parâmetros

debuggeePID
[in] Identificador de processo do processo do qual CLRs carregados serão enumerados.

ppHandleArrayOut
[out] Ponteiro para uma matriz que contém identificadores de evento que são usados para continuar uma inicialização de CLR. Não é garantido que cada identificador na matriz seja válido. Se válido, o identificador será usado como evento de inicialização contínua para o runtime correspondente localizado no mesmo índice de ppStringArrayOut.

ppStringArrayOut
[out] Ponteiro para uma matriz de cadeias de caracteres que especificam caminhos completos para CLRs carregados no processo.

pdwArrayLengthOut
[out] Ponteiro para um DWORD que contém o comprimento de ppHandleArrayOut e pdwArrayLengthOut, que são de igual tamanho.

Retornar valor

S_OK
O número de CLRs no processo foi determinado com êxito e as matrizes de identificador e caminho correspondentes foram preenchidas corretamente.

E_INVALIDARG
Se ppHandleArrayOut ou ppStringArrayOut for nulo ou pdwArrayLengthOut for nulo.

E_OUTOFMEMORY
A função não consegue alocar memória suficiente para as matrizes de identificador e caminho.

E_FAIL (ou outros códigos de retorno E_)
Não é possível enumerar CLRs carregados.

Comentários

Para um processo de destino identificado por debuggeePID, a função retorna uma matriz de caminhos, ppStringArrayOut, para CLRs carregados no processo; uma matriz de identificadores de evento, ppHandleArrayOut, que pode conter um evento de inicialização contínua para o CLR no mesmo índice; e o tamanho das matrizes, pdwArrayLengthOut, que especifica o número de CLRs que são carregados.

No sistema operacional Windows, debuggeePID mapeia para um identificador de processo do sistema operacional.

A memória para ppHandleArrayOut e ppStringArrayOut é alocada por essa função. Para liberar a memória alocada, você deve chamar a Função CloseCLREnumeration.

Essa função pode ser chamada com ambos os parâmetros de matriz definidos como nulos para retornar a contagem de CLRs no processo de destino. Nessa contagem, um chamador pode inferir o tamanho do buffer que será criado: (sizeof(HANDLE) * count) + (sizeof(LPWSTR) * count) + (sizeof(WCHAR*) * count * MAX_PATH).

Requisitos

Plataformas: confira Sistemas operacionais com suporte no .NET.

Cabeçalho: dbgshim.h

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

Versões do .NET: disponível desde o .NET Core 2.1

Compartilhar via