NdrInterfacePointerUnmarshall function

The NdrInterfacePointerUnmarshall function unmarshalls the data referenced by the interface pointer from the network buffer to memory.

Syntax


RPCRTAPI unsigned char* RPC_ENTRY NdrInterfacePointerUnmarshall(
  _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. Structure is for internal use only; do not modify.

ppMemory [out]

Pointer to a pointer to the unmarshalled interface pointer.

pFormat [in]

Pointer to the format string description.

fMustAlloc [in]

Unused.

Return value

Returns NULL upon success. If an error occurs, the function throws one of the following exception codes. In addition, the function can throw exception codes from CoUnmarshalInterface.

ErrorDescription
RPC_BAD_STUB_DATA The network buffer is incorrect.
RPC_S_OUT_OF_MEMORYThe system is out 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 (include Rpc.h)

Library

RpcRT4.lib

DLL

RpcRT4.dll

 

 

Show: