IMiniSH::GetAddressFromSymbol (Windows Embedded CE 6.0)
1/5/2010
This method gets the absolute address of a symbol.
Syntax
HRESULT GetAddressFromSymbol(
DWORD dwPid,
LPCWSTR pszModule,
LPCWSTR pszSource,
LPCWSTR pszRoutine,
LPCWSTR pszSymbol,
ADDRESS_TYPE* pAddress
);
Parameters
- dwPid
[in] Process ID, if applicable.
- pszModule
[in] Name of the module.
pszSource
[in, unique]Name of the source file.The value can be NULL.
pszRoutine
[in, unique]Name of the routine containing the symbol.The value can be NULL.
- pszSymbol
[in] Name of the symbol.
- pOffset
[out] Pointer to the symbol address.
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
IMiniSH::SetSymbolPath must be called prior to this method for it to succeed.
ulPid differentiates between processes that have the same module name. On Windows Embedded CE, ulPid is interpreted as the slot number.
The following table describes behavior based on the values of ulPid and pszModule.
| ulPid | pszModule | Result |
|---|---|---|
0 |
NULL |
Failure. |
0 |
*.EXE |
Address in lowest numbered process of pszModule. |
0 |
*.DLL |
Address in module (zero-based). |
>0 |
NULL |
Address in process with specified PID. |
>0 |
*.EXE |
Address in process with specified PID. Process must have the same module name as pszModule. |
>0 |
*.DLL |
Failure. |
Requirements
| Header | MiniSH.h |
| Library | ole32.lib, oleaut32.lib |
| Windows Embedded CE | Windows CE 5.0 and later |