IDebugSymbols3::GetModuleNames-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetModuleNames--Methode gibt die Namen des angegebenen Moduls zurück.

Syntax

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
);

Parameter

[in] Index

Gibt den Index des Moduls an, dessen Namen angefordert werden. Wenn es auf DEBUG_ANY_ID festgelegt ist, wird das Modul durch Base-angegeben.

[in] Base

Gibt die Basisadresse des Moduls an, dessen Namen angefordert werden. Dieser Parameter wird nur verwendet, wenn Index- auf DEBUG_ANY_ID festgelegt ist.

[out, optional] ImageNameBuffer

Empfängt den Bildnamen des Moduls. Wenn ImageNameBuffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] ImageNameBufferSize

Gibt die Größe in Zeichen des Puffers ImageNameBuffer- in Zeichen an. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] ImageNameSize

Empfängt die Größe in Zeichen des Bildnamens. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn ImageNameSize-NULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] ModuleNameBuffer

Empfängt den Modulnamen des Moduls. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn ModuleNameBuffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] ModuleNameBufferSize

Gibt die Größe in Zeichen des Puffers ModuleNameBufferan. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] ModuleNameSize

Empfängt die Größe in Zeichen des Modulnamens. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn ModuleNameSizeNULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] LoadedImageNameBuffer

Empfängt den geladenen Bildnamen des Moduls. Wenn LoadedImageNameBuffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] LoadedImageNameBufferSize

Gibt die Größe in Zeichen des Puffers LoadedImageNameBufferan. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] LoadedImageNameSize

Empfängt die Größe in Zeichen des geladenen Bildnamens. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn LoadedImageNameSizeNULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch andere Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Mindestens einer von ImageNameBuffer, ModuleNameBufferoder LoadedImageNameBuffer war für den entsprechenden Namen zu klein, sodass er abgeschnitten wurde.
E_NOINTERFACE	Das angegebene Modul wurde nicht gefunden.