MesIncrementalHandleReset function (midles.h)

Article
04/02/2021

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