CoGetInterfaceAndReleaseStream

Unmarshals a buffer containing an interface pointer and releases the stream when an interface pointer has been marshaled from another thread to the calling thread.

HRESULT CoGetInterfaceAndReleaseStream(

LPSTREAM pStm,

//Pointer to the stream from which the object is to be marshaled

REFIID riid,

//Reference to the identifier of the interface

LPVOID * ppv

//Indirect pointer to the interface

);

Parameters

pStm: [in] Pointer to the IStream interface on the stream to be unmarshaled.
riid: [in] Reference to the identifier of the interface requested from the unmarshaled object.
ppv: [out] Indirect pointer to the unmarshaled interface.

Return Values

This function supports the standard return value E_INVALIDARG, as well as the following:

S_OK: Indicates the output interface was unmarshaled and the stream was released.

This function can also return any of the values returned by CoUnmarshalInterface.

Remarks

The CoGetInterfaceAndReleaseStream function performs the following tasks:

Calls CoUnmarshalInterface to unmarshal an interface pointer previously passed in a call to CoMarshalInterThreadInterfaceInStream.
Releases the stream pointer. Even if the unmarshaling fails, the stream is still released because there is no effective way to recover from a failure of this kind.

LPSTREAM pStm,	//Pointer to the stream from which the object is to be marshaled
REFIID riid,	//Reference to the identifier of the interface
LPVOID * ppv	//Indirect pointer to the interface
);