Metodo IDebugSymbols::GetModuleNames (dbgeng.h)

Articolo
08/07/2023

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 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 immagine caricato. 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 altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, almeno uno di ImageNameBuffer, ModuleNameBuffer o LoadedImageNameBuffer era troppo piccolo per il nome corrispondente, quindi è stato troncato.
E_NOINTERFACE	Il modulo specificato non è stato trovato.