Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
This method gets the name of the symbol with the highest starting offset that is less than or equal to a given offset from a module. In addition, this method gets the distance of that symbol's starting offset from the given offset.
HRESULT GetNearestSymbolFromOffset( ADDRESS_TYPEOffset,LPCWSTRpszModule,LPWSTR*ppszSource,LPWSTR*ppszRoutine, LPWSTR*ppszSymbol,DWORD*pdwDistance);
Parameters
Offset
[in] Offset from the beginning of the module.pszModule
[in] Name of the module.ppszSource
[out] Pointer to the name of the source file that contains the symbol.If the module is in-process, the value can be NULL.
ppszRoutine
[out] Pointer to the name of the routine that contains the symbol.If the module is in-process, the value can be NULL.
ppszSymbol
[out] Pointer to the name of the symbol.pdwDistance
[out] Pointer to the distance of the symbol from the given offset.
Return Values
The following table shows the return values for this method.
| Value | Description |
|---|---|
| S_OK | Indicates the function was successful. |
| E_INVALIDARG | Indicates one or more invalid arguments. |
| E_POINTER | Indicates one or more invalid pointer values. |
| E_OUTOFMEMORY | Indicates an out of memory error. |
| E_FAIL | Indicates an unspecified failure. |
Remarks
If the contents of any of the pointers *ppszSource, *ppszRoutine, and *ppszSymbol is not NULL, it must be released by the client with a call to CoTaskMemFree.
IMiniSH::SetSymbolPath must be called prior to this method for it to succeed.
Requirements
OS Version: Windows CE 5.0 and later.
Header: MiniSH.h.
Link Library: ole32.lib, oleaut32.lib.
See Also
Send Feedback on this topic to the authors