IMiniSH::GetNearestSymbolFromAddress (Windows CE 5.0)
This method gets the name of the symbol with the highest starting address that is less than or equal to a given absolute address. In addition, this method gets the distance from the symbol starting address to the given address.
HRESULT GetNearestSymbolFromAddress( ADDRESS_TYPEAddress,DWORD*pdwPid,LPWSTR*ppszModule,LPWSTR*ppszSource,LPWSTR* ppszRoutine,LPWSTR*ppszSymbol,DWORD*pdwDistance);
Parameters
Offset
[in] The absolute address.pdwPid
[out] The process identifier, if the symbol is in a processppszModule
[out] Pointer to the name of the module containing the symbol.If the module is in-process, the value can be NULL.
ppszSource
[out] Pointer to the name of the source file containing the symbol.If the module is in-process, the value can be NULL.
ppszRoutine
[out] Pointer to the name of the routine containing 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 value of the distance of the symbol from the given offset.
Return Values
The following table shows 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