Metodo IDebugSymbols3::GetModuleNameStringWide (dbgeng.h)

Articolo
02/25/2024

Il metodo GetModuleNameStringWide restituisce il nome del modulo specificato.

Sintassi

HRESULT GetModuleNameStringWide(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PWSTR   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  NameSize
);

Parametri

[in] Which

Specifica quale dei nomi del modulo da restituire, i valori possibili sono:

Valore	Descrizione
DEBUG_MODNAME_IMAGE	Nome dell'immagine. Si tratta del nome del file eseguibile, inclusa l'estensione. In genere, il percorso completo è incluso in modalità utente, ma non in modalità kernel.
DEBUG_MODNAME_MODULE	Nome del modulo. Questo è in genere solo il nome del file senza l'estensione. In alcuni casi, il nome del modulo differisce in modo significativo dal nome del file.
DEBUG_MODNAME_LOADED_IMAGE	Nome immagine caricato. A meno che non siano presenti simboli di Microsoft CodeView, si tratta dello stesso nome dell'immagine.
DEBUG_MODNAME_SYMBOL_FILE	Nome del file di simbolo. Percorso e nome del file di simboli. Se non sono stati caricati simboli, questo è il nome del file eseguibile.
DEBUG_MODNAME_MAPPED_IMAGE	Nome immagine mappato. Nella maggior parte dei casi, si tratta di NULL. Se il debugger esegue il mapping di un file di immagine,ad esempio durante il debug minidump, si tratta del nome dell'immagine mappata.

[in] Index

Specifica l'indice del modulo. Se è impostato su DEBUG_ANY_ID, il parametro Base viene usato per specificare il percorso del modulo.

[in] Base

Se Index è DEBUG_ANY_ID, specifica il percorso nello spazio degli indirizzi di memoria della destinazione della base del modulo. In caso contrario, viene ignorato.

[out, optional] Buffer

Riceve il nome del modulo. Se buffer è NULL, queste informazioni non vengono restituite.

[in] BufferSize

Specifica le dimensioni in caratteri del buffer Buffer. Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] NameSize

Riceve le dimensioni in caratteri del nome del modulo. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se NameSize è NULL, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, le dimensioni del buffer sono state ridotte rispetto alle dimensioni del nome del modulo, quindi è stato troncato per adattarsi al buffer.

Commenti

Per altre informazioni sui moduli, vedere Moduli.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (includere Dbgeng.h)

Vedi anche

GetModuleNames

IDebugSymbols3