MesEncodeDynBufferHandleCreate

The MesEncodeDynBufferHandleCreate function creates an encoding handle and then initializes it for a dynamic buffer style of serialization.

#include <rpc.h>
#include <midles.h>
RPC_STATUS RPC_ENTRY MesEncodeDynBufferHandleCreate( 
  char  *  *  ppBuffer,             
  unsigned long  *  pEncodedSize,   
  handle_t *  pHandle               
);
 

Parameters

ppBuffer

Points to a pointer to the stub-supplied buffer containing the encoding after serialization is complete.

pEncodedSize

Specifies a pointer to the size of the completed encoding. The size will be written to the pointee by the subsequent encoding operation(s).

pHandle

Points to the address to which the handle will be written.

Remarks

The MesEncodeDynBufferHandleCreate routine is used by applications to allocate the memory and initialize the handle for the dynamic buffer style of encoding. When using the dynamic buffer style of encoding, the buffer into which all the encoded data will be placed is supplied by the stub. This buffer will be allocated by the current client memory-management mechanism.

There can be performance implications when using this style for multiple encodings with the same handle. A single buffer is returned from an encoding and data is copied from intermediate buffers. The buffers are released when necessary.

Return Values

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in midles.h.
  Import Library: Link with rpcrt4.lib.

See Also

MesBufferHandleReset, MesHandleFree