Share via

IMiniSH::GetNearestSymbolFromAddress (Windows Embedded CE 6.0)

  • Article

1/5/2010

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.

Syntax

HRESULT GetNearestSymbolFromAddress(
  ADDRESS_TYPE Address,
  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 process

  • ppszModule
    [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 Value

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

Header MiniSH.h
Library ole32.lib, oleaut32.lib
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

IMiniSH Interface