Share via


CeRemoteHeapTranslatePointer (Compact 2013)

3/28/2014

This function converts a pointer to an address that the client process can access.

Syntax

LPVOID CeRemoteHeapTranslatePointer(
  HANDLE hHeap,
  DWORD dwFlags,
  LPVOID ptr
);

Parameters

  • 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

See Also

Reference

Memory Management Functions
CeRemoteHeapCreate
HeapAlloc
HeapReAlloc