Export (0) Print
Expand All

NdrComplexStructUnmarshall function

The NdrComplexStructUnmarshall function unmarshals the complex structure from the network buffer to memory.

Syntax


RPCRTAPI unsigned char* RPC_ENTRY NdrComplexStructUnmarshall(
  _Inout_  PMIDL_STUB_MESSAGE pStubMsg,
  _Out_    unsigned char **ppMemory,
  _In_     PFORMAT_STRING pFormat,
  _In_     unsigned char fMustAlloc
);

Parameters

pStubMsg [in, out]

Pointer to a MIDL_STUB_MESSAGE structure that maintains the current status of the RPC stub. The MIDL_STUB_MESSAGE structure is for internal use only, and must not be modified.

ppMemory [out]

Address to a pointer to the unmarshalled complex structure. If set to null, or if the fMustAlloc parameter is set to TRUE, the stub will allocate the memory.

pFormat [in]

Pointer to the format string description.

fMustAlloc [in]

Flag that specifies whether the stub must allocate the memory into which the complex structure is to be marshaled. Specify TRUE if RPC must allocate ppMemory.

Return value

Returns null upon success. Raises one of the following exceptions upon failure.

ErrorDescription
RPC_BAD_STUB_DATA or RPC_X_INVALID_BOUNDThe network is incorrect.
RPC_S_OUT_OF_MEMORYOut of memory.
STATUS_ACCESS_VIOLATIONAn access violation occurred.
RPC_S_INTERNAL_ERRORAn error occurred in RPC.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

Rpcndr.h

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

See also

MIDL_STUB_MESSAGE

 

 

Community Additions

ADD
Show:
© 2014 Microsoft