Metodo IDebugSymbols3::AddSyntheticModule (dbgeng.h)

Articolo
02/23/2024

Il metodo AddSyntheticModule aggiunge un modulo sintetico all'elenco di moduli gestito dal debugger per il processo corrente.

Sintassi

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

Parametri

[in] Base

Specifica la posizione nello spazio degli indirizzi virtuali del processo della base del modulo sintetico.

[in] Size

Specifica le dimensioni in byte del modulo sintetico.

[in] ImagePath

Specifica il nome dell'immagine del modulo sintetico. Si tratta del nome che verrà restituito come nome del file eseguibile per il modulo sintetico. Il percorso completo deve essere incluso se noto.

[in] ModuleName

Specifica il nome del modulo per il modulo sintetico.

[in] Flags

Impostare su DEBUG_ADDSYNTHMOD_DEFAULT.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere Valori restituiti .

Commenti

L'area di memoria del modulo sintetico, descritta dai parametri Base e Size , non deve sovrapporsi all'area di memoria di qualsiasi altro modulo.

Se tutti i moduli vengono ricaricati, ad esempio chiamando Reload con il parametro Module impostato su una stringa vuota, tutti i moduli sintetici verranno eliminati.

Per altre informazioni sui moduli sintetici, vedere Moduli sintetici.