MesIncrementalHandleReset function (midles.h)

The MesIncrementalHandleReset function re-initializes the handle for incremental serialization.

Syntax

RPC_STATUS MesIncrementalHandleReset(
  handle_t      Handle,
  void          *UserState,
  MIDL_ES_ALLOC AllocFn,
  MIDL_ES_WRITE WriteFn,
  MIDL_ES_READ  ReadFn,
  MIDL_ES_CODE  Operation
);

Parameters

Handle

Handle to be re-initialized.

UserState

Depending on the function, pointer to the user-supplied block that coordinates successive calls to the user-supplied Alloc, Write, and Read functions.

AllocFn

Pointer to the user-supplied Alloc function. This parameter can be NULL if the operation does not require it, or if the handle was previously initiated with the pointer.

WriteFn

Pointer to the user-supplied Write function. This parameter can be NULL if the operation does not require it, or if the handle was previously initiated with the pointer.

ReadFn

Pointer to the user-supplied Read function. This parameter can be NULL if the operation does not require it, or if the handle was previously initiated with the pointer.

Operation

Specifies the operation. Valid operations are MES_ENCODE, MES_ENCODE_NDR64, or MES_DECODE.

Return value

Value Meaning
RPC_S_OK
The call succeeded.
RPC_S_INVALID_ARG
The argument was invalid.
RPC_S_OUT_OF_MEMORY
Out of memory.
 
Note  For a list of valid error codes, see RPC Return Values.
 

Remarks

The MesIncrementalHandleReset routine is used by applications to re-initialize the handle for the incremental style of encoding or decoding. For additional information on the user-supplied Alloc, Write, and Read functions, see Serialization Services.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header midles.h (include Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

See also

Alloc

MesBufferhandleReset

MesEncodeIncrementalHandleCreate

MesHandleFree