EstimateFileRiskLevel-Funktion

[Diese Funktion ist unter Windows XP mit Service Pack 2 (SP2) über Windows Vista verfügbar. In nachfolgenden Versionen von Windows ist sie möglicherweise geändert oder nicht verfügbar. Clientanwendungen sollten stattdessen IAttachmentExecute verwenden, um eine Benutzerumgebung zu präsentieren, die einen sicheren Download und Austausch von Dateien über E-Mail- und Messaginganlagen ermöglicht.]

Schätzt das Risiko der Ausführung unbekannten Codes, wenn ein Handler für eine bestimmte Datei aufgerufen wird. Dieses Risiko basiert auf einem Verständnis des Handlers und des Codeinhalts der Datei.

Syntax

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

Parameter

pszFilePath [in]

Typ: LPCWSTR

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Pfad der Datei enthält, die mit dem Handler überprüft wird.

pszExt [in]

Typ: LPCWSTR

Ein Zeiger auf eine null-beendete Zeichenfolge, die die Erweiterung der Datei enthält, die überprüft wird, entweder mit oder ohne ihren vorangestellten Zeitraum. Für instance ".txt" oder "txt".

pszHandler [in]

Typ: LPCWSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die den Pfad des Handlers für die Datei enthält.

pfrlEstimate [out]

Typ: FILE_RISK_LEVEL*

Wenn diese Funktion erfolgreich zurückgegeben wird, enthält einen Zeiger auf einen der folgenden Werte, in denen das geschätzte Risiko angegeben wird.

FRL_NO_OPINION (0)

Das Format der Datei wird nicht oder der Handler nicht identifiziert. Unzureichende Informationen für eine aussagekräftige Antwort.

FRL_LOW (1)

Das Format der Datei ist vollständig verstanden, der Handler ist bekannt, und es besteht hohe Sicherheit, dass kein fremder Code ausgeführt wird.

FRL_MODERATE (2)

Das Format der Datei ist identifiziert, aber es ist nicht ausreichend verstanden, um entweder als hohes oder niedriges Risiko zu bezeichnen.

FRL_HIGH (3)

Das Dateiformat ist verstanden, und es wurden erhöhte Risikofaktoren identifiziert.

FRL_BLOCK (4)

Das Dateiformat ist speziell für diesen Handler blockiert.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Diese Funktion wird nicht in einem öffentlichen Header deklariert oder in einer Bibliotheksdatei enthalten. Um es zu verwenden, müssen Sie es direkt aus Winshfhc.dll durch Ordnungszahl 101 laden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
DLL	Winshfhc.dll (Version 5.1 oder höher)