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.
| Error | Description |
|---|---|
| RPC_BAD_STUB_DATA or RPC_X_INVALID_BOUND | The network is incorrect. |
| RPC_S_OUT_OF_MEMORY | Out of memory. |
| STATUS_ACCESS_VIOLATION | An access violation occurred. |
| RPC_S_INTERNAL_ERROR | An 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 |
|
|
Library |
|
|
DLL |
|
See also