IDebugSymbols3::GetNameByOffsetWide-Methode (dbgeng.h)
Die GetNameByOffsetWide-Methode gibt den Namen des Symbols an der angegebenen Position im virtuellen Adressraum des Ziels zurück.
Syntax
HRESULT GetNameByOffsetWide(
[in] ULONG64 Offset,
[out, optional] PWSTR NameBuffer,
[in] ULONG NameBufferSize,
[out, optional] PULONG NameSize,
[out, optional] PULONG64 Displacement
);
Parameter
[in] Offset
Gibt den Speicherort im virtuellen Adressraum des Symbols an, dessen Name angefordert wird. Offset muss die Basisposition des Symbols nicht angeben. Es muss nur ein Speicherort innerhalb der Speicherbelegung des Symbols angegeben werden.
[out, optional] NameBuffer
Empfängt den Namen des Symbols. Der Name wird durch das Modul qualifiziert, zu dem das Symbol gehört (z. B. mymodule!Standard). Wenn NameBufferNULL ist, werden diese Informationen nicht zurückgegeben.
[in] NameBufferSize
Gibt die Größe des Puffers NameBuffer in Zeichen an. Diese Größe enthält den Leerraum für das "\0"-Endzeichen.
[out, optional] NameSize
Empfängt die Größe des Symbolnamens in Zeichen. Diese Größe enthält den Leerraum für das "\0"-Endzeichen. Wenn NameSizeNULL ist, werden diese Informationen nicht zurückgegeben.
[out, optional] Displacement
Empfängt die Differenz zwischen dem Wert von Offset und der Basisposition des Symbols. Wenn die VerschiebungNULL 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 |
|---|---|
|
Die Methode war erfolgreich. |
|
Die Methode war erfolgreich. Der Puffer war jedoch nicht groß genug, um den Namen des Symbols zu enthalten, sodass er abgeschnitten wurde. |
|
An der angegebenen Position konnte kein Symbol gefunden werden. |
Hinweise
Weitere Informationen zu Symbolen und Symbolnamen finden Sie unter Symbole.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | dbgeng.h (dbgeng.h einschließen) |