Функция EstimateFileRiskLevel

[Эта функция доступна в Windows XP с пакетом обновления 2 (SP2) через Windows Vista. Она может быть изменена или недоступна в последующих версиях Windows. Вместо этого клиентские приложения должны использовать IAttachmentExecute для представления пользовательской среды, которая обеспечивает безопасное скачивание и обмен файлами через электронную почту и вложения сообщений.]

Оценивает риск выполнения неизвестного кода при вызове обработчика для заданного файла. Этот риск основан на понимании обработчика и содержимого кода файла.

Синтаксис

HRESULT EstimateFileRiskLevel(
  _In_  LPCWSTR         pszFilePath,
  _In_  LPCWSTR         pszExt,
  _In_  LPCWSTR         pszHandler,
  _Out_ FILE_RISK_LEVEL *pfrlEstimate
);

Параметры

pszFilePath [in]

Тип: LPCWSTR

Указатель на строку, завершающуюся нулевым значением, которая содержит путь к файлу, который проверяется в обработчике.

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 .

Комментарии

Эта функция не объявлена в общедоступном заголовке и не включена в файл библиотеки. Чтобы использовать его, его необходимо загрузить непосредственно из Winshfhc.dll по порядковой номеру 101.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
DLL	Winshfhc.dll (версия 5.1 или более поздняя)