Metodo IDebugSymbols3::AddSyntheticModuleWide (dbgeng.h)

Articolo
02/23/2024

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

Sintassi

HRESULT AddSyntheticModuleWide(
  [in] ULONG64 Base,
  [in] ULONG   Size,
  [in] PCWSTR  ImagePath,
  [in] PCWSTR  ModuleName,
  [in] ULONG   Flags
);

Parametri

[in] Base

Specifica il percorso nello spazio indirizzi virtuale 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. Questo è il 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 altre informazioni, 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 Ricarica con il parametro Module impostato su una stringa vuota, tutti i moduli sintetici verranno eliminati.

Per altre informazioni sui moduli sintetici, vedere Moduli sintetici.