CeRemoteHeapTranslatePointer
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This function converts a pointer to an address that the client process can access.
Syntax
LPVOID CeRemoteHeapTranslatePointer(
HANDLE hHeap,
DWORD dwFlags,
LPVOID ptr
);
Parameters
- hHeap
Handle returned by CeRemoteHeapCreate.
- dwFlags
Set to zero or CE_HEAP_REVERSE_TRANSLATE. If CE_HEAP_REVERSE_TRANSLATE is specified, it translates a client pointer to server pointer.
- ptr
Pointer returned from HeapAlloc or HeapReAlloc on a remote heap if dwFlags is zero (0). Or a pointer that is translated to client if CE_HEAP_REVERSE_TRANSLATE is specified.
Return Value
Pointer to client memory that can be passed to the client process to read and write to the memory.
Remarks
The safe remote heap APIs: CeRemoteHeapCreate, and CeRemoteHeapTranslatePointer, provide a safe and efficient way of dynamically allocating and freeing memory asynchronously in an arbitrary client process.
Requirements
| Header | pkfuncs.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows Embedded CE 6.0 and later |
See Also
Reference
Memory Management Functions
CeRemoteHeapCreate
HeapAlloc
HeapReAlloc