FltSupportsFileContextsEx 函式 (fltkernel.h)
FltSupportsFileContextsEx 例程會決定文件系統或篩選管理員是否支援指定檔案的檔案內容。
語法
BOOLEAN FLTAPI FltSupportsFileContextsEx(
[in] PFILE_OBJECT FileObject,
[in, optional] PFLT_INSTANCE Instance
);
參數
[in] FileObject
表示正在查詢其檔案內容支援的檔案之檔案物件的指標。 這是必要參數,而且無法 NULL。
[in, optional] Instance
呼叫端的不透明實例指標。 這個參數是選擇性的,而且可以 NULL。 如需此參數的詳細資訊,請參閱此頁面的一節。
傳回值
如果文件系統或篩選管理員支援檔案內容,FltSupportsFileContextsEx 會傳回 true TRUE;否則 FALSE。
言論
Minifilter 驅動程式可以呼叫 FltSupportsFileContextsEx 例程,以判斷基礎文件系統或篩選管理員是否支援 FileObject 所代表檔案的檔案內容,而不需要配置內容並嘗試設定它。 如果檔案上不支持內容類型,則迷你篩選無法將內容附加至該檔案。
對於僅支援每個檔案單一數據流的文件系統(例如 FAT),檔案內容相當於數據流內容。 這類文件系統通常支持數據流內容,但不支援檔案內容。 相反地,篩選管理員會使用文件系統現有數據流內容的支援,提供檔案內容支援。 對於附加至這些文件系統的小型篩選實例,FltSupportsFileContexts 會傳回 FALSE,而 FltSupportsFileContextsEx 會傳回 true TRUE (當有效的非NULL 值針對 實例 參數傳遞時)。
如果 實例 參數提供非NULL 值,FltSupportsFileContextsEx 如果文件系統或篩選管理員支援檔案內容的檔案內容,則會傳 回 TRUE;否則 FALSE。
如果 Instance 參數 NULL,FltSupportsFileContextsEx 只有在文件系統支援檔案內容的檔案內容時,才會傳回 true TRUE。 否則會傳回 FALSE,即使篩選管理員支援檔案的檔案內容也一樣。
請注意,檔案系統可能支援某些檔案類型的檔案內容,但不支援其他文件類型。 例如,NTFS 和 FAT 不支援分頁檔案的檔案內容。
如需內容的詳細資訊,請參閱 關於小型篩選內容。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 此例程適用於 Windows Vista 和更新版本。 |
目標平臺 | 普遍 |
標頭 | fltkernel.h (包括 Fltkernel.h) |
連結庫 | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | <= APC_LEVEL |