Metodo IDebugSymbols3::GetModuleNameStringWide (dbgeng.h)

Articolo
02/06/2025

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 i 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 dell'immagine caricato. A meno che non siano presenti simboli di Microsoft CodeView, corrisponde al nome dell'immagine.
DEBUG_MODNAME_SYMBOL_FILE	Nome del file di simboli. Percorso e nome del file di simboli. Se non sono stati caricati simboli, si tratta invece del nome del file eseguibile.
DEBUG_MODNAME_MAPPED_IMAGE	Nome dell'immagine mappata. 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 di minidump), questo è il nome dell'immagine mappata.

[in] Index

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

[in] Base

Se Index è DEBUG_ANY_ID, specifica la posizione 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 altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo. Tuttavia, le dimensioni del buffer erano inferiori rispetto alle dimensioni del nome del modulo in modo da essere troncate per adattarsi al buffer.

Osservazioni

Per altre informazioni sui moduli, vedere Modules.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Vedere anche

GetModuleNames

IDebugSymbols3

Condividi tramite