Skip to content

Latest commit

 

History

History
82 lines (64 loc) · 3.14 KB

nf-combaseapi-coallowunmarshalerclsid.md

File metadata and controls

82 lines (64 loc) · 3.14 KB
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.CoAllowUnmarshalerCLSID
CoAllowUnmarshalerCLSID function (combaseapi.h)
Adds an unmarshaler CLSID to the allowed list for the calling process only.
CoAllowUnmarshalerCLSID
CoAllowUnmarshalerCLSID function [COM]
com.coallowunmarshalerclsid
combaseapi/CoAllowUnmarshalerCLSID
com\coallowunmarshalerclsid.htm
com
4655C6B6-02CE-42B2-A157-0C0325D1BE52
12/05/2018
CoAllowUnmarshalerCLSID, CoAllowUnmarshalerCLSID function [COM], com.coallowunmarshalerclsid, combaseapi/CoAllowUnmarshalerCLSID
combaseapi.h
Windows
Windows 8
Windows Server 2012
Ole32.lib
Ole32.dll
Windows
19H1
CoAllowUnmarshalerCLSID
combaseapi/CoAllowUnmarshalerCLSID
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
CoAllowUnmarshalerCLSID

CoAllowUnmarshalerCLSID function

-description

Adds an unmarshaler CLSID to the allowed list for the calling process only.

-parameters

-param clsid [in]

The CLSID of the unmarshaler to be added to the per-process allowed list.

-returns

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

Don't call the CoAllowUnmarshalerCLSID function until after CoInitializeSecurity has been called in the current process.

The CoAllowUnmarshalerCLSID function provides more granular control over unmarshaling policy than is provided by the policy options. If the process applies any unmarshaling policy, the effect of the CoAllowUnmarshalerCLSID function is to make the policy comparatively weaker. For this reason, only call CoAllowUnmarshalerCLSID when the security impact is well understood. Usually, this is used to facilitate applying a stronger unmarshaling policy option for the broad attack surface reduction this provides, when a specific unmarshaler CLSID not allowed by that option is needed due to other constraints.

For example, it's appropriate to call the CoAllowUnmarshalerCLSID function when an unmarshaler is known or believed to have a vulnerability but is required by an app. Also, it's appropriate to call CoAllowUnmarshalerCLSID if the unmarshaler is used in multiple processes, but only as part of an uncommon feature. Don't use the CoAllowUnmarshalerCLSID function as a replacement for hardening the unmarshaler.

-see-also

GLOBALOPT_UNMARSHALING_POLICY_VALUES

IMarshalingStream