[此函数通过 Windows Vista 在 Service Pack 2 (SP2) 的 Windows XP 上可用。 它在后续版本的 Windows 中可能已更改或不可用。 客户端应用程序应改为使用 IAttachmentExecute 来呈现一个用户环境,该环境通过电子邮件和消息附件提供文件的安全下载和交换。]
估计在给定文件上调用处理程序时执行未知代码的风险。 此风险基于对处理程序和文件代码内容的理解。
语法
HRESULT EstimateFileRiskLevel(
_In_ LPCWSTR pszFilePath,
_In_ LPCWSTR pszExt,
_In_ LPCWSTR pszHandler,
_Out_ FILE_RISK_LEVEL *pfrlEstimate
);
parameters
-
pszFilePath [in]
-
类型: LPCWSTR
指向以 null 结尾的字符串的指针,该字符串包含针对处理程序检查的文件的路径。
-
pszExt [in]
-
类型: LPCWSTR
指向以 null 结尾的字符串的指针,该字符串包含要检查的文件的扩展名,无论是否具有前导句点。 例如,“.txt”或“txt”。
-
pszHandler [in]
-
类型: LPCWSTR
指向以 null 结尾的字符串的指针,该字符串包含文件的处理程序的路径。
-
pfrlEstimate [out]
-
类型: FILE_RISK_LEVEL*
当此函数成功返回时, 包含指向以下值之一的指针,这些值声明估计的风险。
-
FRL_NO_OPINION (0)
-
未标识文件的格式或未标识处理程序。 可用信息不足,无法获得有意义的答案。
-
FRL_LOW (1)
-
完全理解文件的格式,处理程序是已知的,并且高度确信不会执行任何无关的代码。
-
FRL_MODERATE (2)
-
文件的格式已确定,但尚未充分理解,无法将其标记为高风险或低风险。
-
FRL_HIGH (3)
-
了解文件格式并识别了提升的风险因素。
-
FRL_BLOCK (4)
-
此处理程序专门阻止文件格式。
返回值
类型: HRESULT
如果此函数成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。
备注
此函数未在公共标头中声明,也不包含在库文件中。 若要使用它,必须直接从按序号 101 Winshfhc.dll加载它。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP SP2 [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
DLL |
|