Freigeben über


IDebugSymbols::GetModuleNames-Methode (dbgeng.h)

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 Leerraum für das "\0"-Endzeichen.

[out, optional] ImageNameSize

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

[out, optional] ModuleNameBuffer

Empfängt den Modulnamen des Moduls. 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 Leerraum für das "\0"-Endzeichen.

[out, optional] ModuleNameSize

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

[out, optional] LoadedImageNameBuffer

Empfängt den namen des geladenen Bilds 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 Leerraum für das "\0"-Endzeichen.

[out, optional] LoadedImageNameSize

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

Rückgabewert

Diese Methode gibt möglicherweise auch andere Fehlerwerte zurück. 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.

Hinweise

Weitere Informationen zu Modulen finden Sie unter Module.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

GetModuleNameString

IDebugSymbols

IDebugSymbols2

IDebugSymbols3