Método IDebugSymbols::GetNumberModules (dbgeng.h)

Artigo
02/23/2024

O método GetNumberModules retorna o número de módulos na lista de módulos do processo atual.

Sintaxe

HRESULT GetNumberModules(
  [out] PULONG Loaded,
  [out] PULONG Unloaded
);

Parâmetros

[out] Loaded

Recebe o número de módulos carregados na lista de módulos do processo atual.

[out] Unloaded

Recebe o número de módulos descarregados na lista de módulos do processo atual. Esse número será zero se a versão do Microsoft Windows em execução no computador de destino não rastrear módulos descarregados.

Retornar valor

Esse método também pode retornar outros valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

A lista de módulos carregados e descarregados é mantida pelo Windows. O mecanismo armazena em cache uma cópia dessa lista, mas pode ficar desatualizada. O recarregamento pode ser usado para sincronizar a cópia da lista do mecanismo com a lista mantida pelo Windows.

Os módulos descarregados não são rastreados em todas as versões do Windows. Os módulos descarregados são rastreados para destinos no modo de usuário no Microsoft Windows Server 2003 e posteriores; para destinos no modo kernel, os módulos descarregados também são rastreados em versões anteriores do Windows. Quando são rastreados, eles são indexados após os módulos carregados. Os módulos descarregados podem ser usados para analisar falhas causadas por uma tentativa de chamar o código descarregado.

Para obter mais informações sobre módulos, consulte Módulos.