Función EstimateFileRiskLevel

[Esta función está disponible en Windows XP con Service Pack 2 (SP2) a través de Windows Vista. Es posible que se modifique o no esté disponible en versiones posteriores de Windows. En su lugar, las aplicaciones cliente deben usar IAttachmentExecute para presentar un entorno de usuario que proporciona descarga y intercambio seguro de archivos a través de datos adjuntos de correo electrónico y mensajería.

Calcula el riesgo de ejecutar código desconocido cuando se llama a un controlador en un archivo determinado. Este riesgo se basa en una comprensión del controlador y el contenido del código del archivo.

Sintaxis

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

Parámetros

pszFilePath [in]

Tipo: LPCWSTR

Puntero a una cadena terminada en null que contiene la ruta de acceso del archivo que se está comprobando en el controlador.

pszExt [in]

Tipo: LPCWSTR

Puntero a una cadena terminada en null que contiene la extensión del archivo que se está comprobando, ya sea con o sin su punto inicial. Por ejemplo, ".txt" o "txt".

pszHandler [in]

Tipo: LPCWSTR

Puntero a una cadena terminada en null que contiene la ruta de acceso del controlador para el archivo.

pfrlEstimate [out]

Tipo: FILE_RISK_LEVEL*

Cuando esta función se devuelve correctamente, contiene un puntero a uno de los siguientes valores que muestran el riesgo estimado.

FRL_NO_OPINION (0)

El formato del archivo no se identifica o no se identifica el controlador. Información insuficiente disponible para una respuesta significativa.

FRL_LOW (1)

El formato del archivo se entiende por completo, se conoce el controlador y hay alta confianza de que no se ejecutará ningún código extraño.

FRL_MODERATE (2)

El formato del archivo se identifica, pero no se entiende suficientemente para etiquetar como un riesgo alto o bajo.

FRL_HIGH (3)

Se ha identificado el formato de archivo y se han identificado factores de riesgo elevados.

FRL_BLOCK (4)

El formato de archivo está bloqueado específicamente para este controlador.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

Esta función no se declara en un encabezado público ni se incluye en un archivo de biblioteca. Para usarlo, debe cargarlo directamente desde Winshfhc.dll por ordinal 101.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Archivo DLL	Winshfhc.dll (versión 5.1 o posterior)