Metodo IDebugSymbols2::GetModuleNames (dbgeng.h)

Articolo
02/06/2025

Il metodo GetModuleNames restituisce i nomi del modulo specificato.

Sintassi

HRESULT GetModuleNames(
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    ImageNameBuffer,
  [in]            ULONG   ImageNameBufferSize,
  [out, optional] PULONG  ImageNameSize,
  [out, optional] PSTR    ModuleNameBuffer,
  [in]            ULONG   ModuleNameBufferSize,
  [out, optional] PULONG  ModuleNameSize,
  [out, optional] PSTR    LoadedImageNameBuffer,
  [in]            ULONG   LoadedImageNameBufferSize,
  [out, optional] PULONG  LoadedImageNameSize
);

Parametri

[in] Index

Specifica l'indice del modulo i cui nomi sono richiesti. Se è impostato su DEBUG_ANY_ID, il modulo viene specificato da Base.

[in] Base

Specifica l'indirizzo di base del modulo i cui nomi sono richiesti. Questo parametro viene usato solo se Index è impostato su DEBUG_ANY_ID.

[out, optional] ImageNameBuffer

Riceve il nome dell'immagine del modulo. Se ImageNameBuffer è null, queste informazioni non vengono restituite.

[in] ImageNameBufferSize

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

[out, optional] ImageNameSize

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

[out, optional] ModuleNameBuffer

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

[in] ModuleNameBufferSize

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

[out, optional] ModuleNameSize

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

[out, optional] LoadedImageNameBuffer

Riceve il nome dell'immagine caricata del modulo. Se LoadedImageNameBuffer è NULL, queste informazioni non vengono restituite.

[in] LoadedImageNameBufferSize

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

[out, optional] LoadedImageNameSize

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

Valore restituito

Questo metodo può anche restituire altri 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, almeno uno dei ImageNameBuffer, ModuleNameBuffero LoadedImageNameBuffer era troppo piccolo per il nome corrispondente, quindi è stato troncato.
E_NOINTERFACE	Il modulo specificato non è stato trovato.

Osservazioni

Per altre informazioni sui moduli, vedere Modules.

Fabbisogno

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

Vedere anche

GetModuleNameString

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

Condividi tramite