Método IDebugSymbols3::GetModuleParameters (dbgeng.h)

Artigo
02/26/2024

O método GetModuleParameters retorna parâmetros para módulos no destino.

Sintaxe

HRESULT GetModuleParameters(
  [in]           ULONG                    Count,
  [in, optional] PULONG64                 Bases,
  [in]           ULONG                    Start,
  [out]          PDEBUG_MODULE_PARAMETERS Params
);

Parâmetros

[in] Count

Especifica o número de módulos cujos parâmetros são desejados.

[in, optional] Bases

Especifica uma matriz de locais no espaço de endereço virtual do destino que representa o endereço base dos módulos cujos parâmetros são desejados. O tamanho dessa matriz é o valor de Count. Se Bases for NULL, o parâmetro Start será usado para especificar os módulos por índice.

[in] Start

Especifica o índice do primeiro módulo cujos parâmetros são desejados. Se Bases não for NULL, esse parâmetro será ignorado.

[out] Params

Recebe os parâmetros. O tamanho dessa matriz é o valor de Count. Confira DEBUG_MODULE_PARAMETERS.

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. No entanto, se Bases não for NULL, é possível que nem todos os módulos tenham sido encontrados, caso em que os resultados parciais são retornados.
E_INVALIDARG	Quando Bases é NULL, esse valor indica que o destino contém menos do que a soma dos módulos Count e Start . Os resultados parciais são retornados.

Comentários

Nos casos em que os resultados parciais são retornados, as entradas na matriz Params correspondentes aos módulos que não puderam ser encontrados têm seu campo Base definido como DEBUG_INVALID_OFFSET. Confira DEBUG_MODULE_PARAMETERS.

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