IDebugSymbols3::GetNearNameByOffset method (dbgeng.h)
The GetNearNameByOffset method returns the name of a symbol that is located near the specified location.
Syntax
HRESULT GetNearNameByOffset(
[in] ULONG64 Offset,
[in] LONG Delta,
[out, optional] PSTR NameBuffer,
[in] ULONG NameBufferSize,
[out, optional] PULONG NameSize,
[out, optional] PULONG64 Displacement
);
Parameters
[in] Offset
Specifies the location in the target's virtual address space of the symbol from which the desired symbol is determined.
[in] Delta
Specifies the relationship between the desired symbol and the symbol located at Offset. If positive, the engine will return the symbol that is Delta symbols after the symbol located at Offset. If negative, the engine will return the symbol that is Delta symbols before the symbol located at Offset.
[out, optional] NameBuffer
Receives the symbol's name. The name is qualified by the module to which the symbol belongs (for example, mymodule!main). If NameBuffer is NULL, this information is not returned.
[in] NameBufferSize
Specifies the size in characters of the buffer NameBuffer. This size includes the space for the '\0' terminating character.
[out, optional] NameSize
Receives the size in characters of the symbol's name. This size includes the space for the '\0' terminating character. If NameSize is NULL, this information is not returned.
[out, optional] Displacement
Receives the difference between the value of Offset and the location in the target's memory address space of the symbol. If Displacement is NULL, this information is not returned.
Return value
This method may also return other error values. See Return Values for more details.
Return code | Description |
---|---|
|
The method was successful. |
|
The method was successful. However, the buffer was not large enough to hold the symbol's name so it was truncated. |
|
No symbol matching the specifications of Offset and Delta was found. |
Remarks
By increasing or decreasing the value of Delta, these methods can be used to iterate over the target's symbols starting at a particular location.
If Delta is zero, these methods behave the same way as GetNameByOffset.
For more information about symbols and symbol names, see Symbols.
Requirements
Requirement | Value |
---|---|
Target Platform | Desktop |
Header | dbgeng.h (include Dbgeng.h) |