Compartilhar via


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

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.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

AddSyntheticSymbol

IDebugSymbols3

RemoveSyntheticModule