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

Artigo
02/26/2024

O método AddSyntheticModule adiciona um módulo sintético à lista de módulos que o depurador mantém para o processo atual.

Sintaxe

HRESULT AddSyntheticModule(
  [in] ULONG64 Base,
  [in] ULONG   Size,
  [in] PCSTR   ImagePath,
  [in] PCSTR   ModuleName,
  [in] ULONG   Flags
);

Parâmetros

[in] Base

Especifica o local no espaço de endereço virtual do processo da base do módulo sintético.

[in] Size

Especifica o tamanho em bytes do módulo sintético.

[in] ImagePath

Especifica o nome da imagem do módulo sintético. Esse é o nome que será retornado como o nome do arquivo executável para o módulo sintético. O caminho completo deve ser incluído, se conhecido.

[in] ModuleName

Especifica o nome do módulo para o módulo sintético.

[in] Flags

Defina como DEBUG_ADDSYNTHMOD_DEFAULT.

Retornar valor

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

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

Comentários

A região de memória do módulo sintético, descrita pelos parâmetros Base e Size , não deve sobrepor a região de memória de nenhum outro módulo.

Se todos os módulos forem recarregados – por exemplo, chamando Recarregar com o parâmetro Module definido como uma cadeia de caracteres vazia – todos os módulos sintéticos serão descartados.

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