EstimateFileRiskLevel-Funktion
[Diese Funktion ist auf Windows XP mit Service Pack 2 (SP2) bis Windows Vista verfügbar. Er kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein. 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 von unbekanntem Code, 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 auf NULL endende Zeichenfolge, die den Pfad der Datei enthält, die für den Handler überprüft wird.
-
pszExt [ In]
-
Typ: LPCWSTR
Ein Zeiger auf eine auf NULL endende Zeichenfolge, die die Erweiterung der datei enthält, die überprüft wird, entweder mit oder ohne ihren führenden Punkt. Beispiel: ".txt" oder "txt".
-
pszHandler [ In]
-
Typ: LPCWSTR
Ein Zeiger auf eine auf NULL endende Zeichenfolge, die den Pfad des Handlers für die Datei enthält.
-
pfrlEstimate [ out]
-
Typ: _ _ DATEIRISIKOSTUFE *
Wenn diese Funktion erfolgreich zurückgegeben wird, enthält einen Zeiger auf einen der folgenden Werte, der das geschätzte Risiko angibt.
-
FRL _ KEINE _ MEINUNG (0)
-
Das Format der Datei wird nicht identifiziert, oder der Handler wird nicht identifiziert. Für eine aussagekräftige Antwort sind nicht genügend Informationen verfügbar.
-
FRL _ LOW (1)
-
Das Format der Datei ist vollständig verständlich, der Handler ist bekannt, und es ist sehr sicher, dass kein überflüssiger Code ausgeführt wird.
-
FRL _ MODERATE (2)
-
Das Format der Datei wird identifiziert, aber es ist nicht ausreichend verstanden, um als ein hohes oder niedriges Risiko zu bezeichnen.
-
FRL _ HIGH (3)
-
Das Dateiformat wird verstanden, und es wurden erhöhte Risikofaktoren identifiziert.
-
FRL _ BLOCK (4)
-
Das Dateiformat wird speziell für diesen Handler blockiert.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ausgeführt wird, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Hinweise
Diese Funktion ist nicht in einem öffentlichen Header deklariert oder in einer Bibliotheksdatei enthalten. Um sie zu verwenden, müssen Sie sie direkt aus Winshfhc.dll von Ordnungszahl 101 laden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur XP mit [ SP2-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| DLL |
|