nf-combaseapi-coreleasemarshaldata.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:combaseapi.CoReleaseMarshalData	CoReleaseMarshalData function (combaseapi.h)	Destroys a previously marshaled data packet.	CoReleaseMarshalData CoReleaseMarshalData function [COM] _com_CoReleaseMarshalData com.coreleasemarshaldata combaseapi/CoReleaseMarshalData	com\coreleasemarshaldata.htm	com	a642a20f-3a3c-46bc-b833-e424dab3a16d	12/05/2018	CoReleaseMarshalData, CoReleaseMarshalData function [COM], _com_CoReleaseMarshalData, com.coreleasemarshaldata, combaseapi/CoReleaseMarshalData	combaseapi.h	Objbase.h	Windows	Windows 2000 Professional [desktop apps \| UWP apps]	Windows 2000 Server [desktop apps \| UWP apps]										Ole32.lib	Ole32.dll		Windows			19H1	CoReleaseMarshalData combaseapi/CoReleaseMarshalData	c++	APIRef kbSyntax	DllExport	Ole32.dll API-MS-Win-Core-Com-l1-1-0.dll ComBase.dll API-MS-Win-Core-Com-l1-1-1.dll API-MS-Win-DownLevel-Ole32-l1-1-0.dll API-MS-Win-DownLevel-Ole32-l1-1-1.dll	CoReleaseMarshalData

CoReleaseMarshalData function

-description

Destroys a previously marshaled data packet.

-parameters

-param pStm [in]

A pointer to the stream that contains the data packet to be destroyed. See IStream.

-returns

This function can return the standard return values E_FAIL, E_INVALIDARG, E_OUTOFMEMORY, and E_UNEXPECTED, as well as the following values.

Return code	Description
S_OK	The data packet was successfully destroyed.
STG_E_INVALIDPOINTER	An error related to the pStm parameter.
CO_E_NOTINITIALIZED	The CoInitialize or OleInitialize function was not called on the current thread before this function was called.

-remarks

Important  

Security Note: Calling this method with untrusted data is a security risk. Call this method only with trusted data.

 

The CoReleaseMarshalData function performs the following tasks:

1. The function reads a CLSID from the stream.
2. If COM's default marshaling implementation is being used, the function gets an IMarshal pointer to an instance of the standard unmarshaler. If custom marshaling is being used, the function creates a proxy by calling the CoCreateInstance function, passing the CLSID it read from the stream, and requests an IMarshal interface pointer to the newly created proxy.
3. Using whichever IMarshal interface pointer it has acquired, the function calls IMarshal::ReleaseMarshalData.

You typically do not call this function. The only situation in which you might need to call this function is if you use custom marshaling (write and use your own implementation of IMarshal). Examples of when CoReleaseMarshalData should be called include the following situations:

• An attempt was made to unmarshal the data packet, but it failed.
• A marshaled data packet was removed from a global table.

As an analogy, the data packet can be thought of as a reference to the original object, just as if it were another interface pointer being held on the object. Like a real interface pointer, that data packet must be released at some point. The use of IMarshal::ReleaseMarshalData to release data packets is analogous to the use of IUnknown::Release to release interface pointers.

Note that you do not need to call CoReleaseMarshalData after a successful call of the CoUnmarshalInterface function; that function releases the marshal data as part of the processing that it does.

Important  You must call the CoReleaseMarshalData function in the same apartment that called CoMarshalInterface to marshal the object into the stream. Failure to do this may cause the object reference held by the marshaled packet in the stream to be leaked.

 

-see-also

IMarshal::ReleaseMarshalData