IDebugSymbols3::GetModuleNames-Methode (dbgeng.h)

Artikel
02/23/2024

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 von 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 Imagenamen des Moduls. Wenn ImageNameBufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] ImageNameBufferSize

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

[out, optional] ImageNameSize

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

[out, optional] ModuleNameBuffer

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

[in] ModuleNameBufferSize

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

[out, optional] ModuleNameSize

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

[out, optional] LoadedImageNameBuffer

Empfängt den geladenen Imagenamen des Moduls. Wenn LoadedImageNameBufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] LoadedImageNameBufferSize

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

[out, optional] LoadedImageNameSize

Empfängt die Größe des geladenen Bildnamens in Zeichen. Diese Größe enthält den Platz für das "\0"-Endzeichen. 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, ModuleNameBuffer oder LoadedImageNameBuffer war jedoch für den entsprechenden Namen zu klein, sodass er abgeschnitten wurde.
E_NOINTERFACE	Das angegebene Modul wurde nicht gefunden.