IAttachmentExecute::CheckPolicy method (shobjidl_core.h)

Provides a Boolean test that can be used to make decisions based on the attachment's execution policy.

Syntax

HRESULT CheckPolicy();

Return value

Type: HRESULT

Returns one of the following values.

Value	Meaning
S_OK	Enable
S_FALSE	Prompt
Any other failure code	Disable

Remarks

IAttachmentExecute::CheckPolicy examines a set of properties known collectively as evidence. Anything used to determine trust level is considered evidence. These properties are set using the following methods.

• IAttachmentExecute::SetFileName
• IAttachmentExecute::SetLocalPath
• IAttachmentExecute::SetReferrer
• IAttachmentExecute::SetSource

The information returned by IAttachmentExecute::CheckPolicy enables an application to modify its UI appropriately for the situation.

IAttachmentExecute::CheckPolicy requires the application first to call either IAttachmentExecute::SetFileName or IAttachmentExecute::SetLocalPath.

Requirements

Requirement	Value
Minimum supported client	Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	shobjidl_core.h (include Shobjidl.h)
DLL	Shdocvw.dll (version 6.0 or later)