CoUnmarshalHresult (Compact 2013)

3/26/2014

This function unmarshals an HRESULT type from the specified stream.

Syntax

STDAPI CoUnmarshalHresult(
  LPSTREAM pStm,
  HRESULT* phresult
);

Parameters

  • pStm
    [in] Pointer to the stream from which the HRESULT is to be unmarshaled.
  • phresult
    [out] Pointer to the unmarshaled HRESULT.

Return Value

This function supports the standard return values E_OUTOFMEMORY and E_UNEXPECTED, as well as the following:

  • S_OK
    The HRESULT was unmarshaled successfully.
  • STG_E_INVALIDPOINTER
    pStm is an invalid pointer.

Remarks

Your application does not explicitly call this function unless performing custom marshaling with a special implementation of IMarshal, and your implementation needs to unmarshal an HRESULT.

The application must use CoUnmarshalHresult to unmarshal HRESULTs previously marshaled by a call to the CoMarshalHresult function.

This function performs the following tasks:

  1. Reads an HRESULT from a stream.
  2. Returns the HRESULT.

To determine whether the platform supports this function, see Determining Supported COM APIs.

Requirements

Header

objbase.h

Library

ole32.lib

See Also

Reference

COM Functions