EstimateFileRiskLevel 函数

[此函数通过 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
Winshfhc.dll (5.1 或更高版本)