IMiniSH::GetNearestSymbolFromOffset (Windows CE 5.0)
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