NdrConformantStringUnmarshall function
The NdrConformantStringUnmarshall function unmarshals the conformant string from the network buffer to memory.
Syntax
RPCRTAPI unsigned char* RPC_ENTRY NdrConformantStringUnmarshall( _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. This structure is for internal use only and should not be modified.
- ppMemory [out]
-
Address to a pointer to the unmarshalled conformant string. If set to null, or if the fMustAlloc 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 conformant string is to be marshaled. Specify TRUE if RPC must allocate ppMemory.
Return value
Returns null upon success. If an error occurs, the function throws one of the following exception codes.
| 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 |
|