Metodo IDebugSymbols3::GetModuleNameString (dbgeng.h)

Articolo
08/07/2023

Il metodo GetModuleNameString restituisce il nome del modulo specificato.

Sintassi

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

Parametri

[in] Which

Specifica quali dei nomi del modulo 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 caricata. A meno che i simboli di Microsoft CodeView non siano presenti, 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, questo è il 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), 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 invece il percorso del modulo.

[in] Base

Se Index è DEBUG_ANY_ID, specifica la posizione nello spazio 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 è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, le dimensioni del buffer sono inferiori 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 (include Dbgeng.h)

Vedi anche

GetModuleNames

IDebugSymbols2

IDebugSymbols3

Condividi tramite