[この関数は、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
);
パラメーター
-
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] |
|