CoUnmarshalHresult

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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

See Also

Reference

COM Functions