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;否則為 FALSE。

備註

Minifilter 驅動程式可以呼叫 FltSupportsFileContextsEx 例程，以判斷基礎文件系統或篩選管理員是否支援 FileObject 所代表檔案的檔案內容，而不需要配置內容並嘗試設定它。 如果檔案不支持內容類型，迷你篩選就無法將內容附加至該檔案。

對於僅支援每個檔案單一數據流的 FAT) 之類的 (檔案系統，檔案內容相當於數據流內容。 這類文件系統通常支持數據流內容，但不支援檔案內容。 相反地，篩選管理員會使用文件系統對數據流內容的現有支援，提供檔案內容支援。 對於附加至這些文件系統的迷你篩選實例，FltSupportsFileContexts 會傳回 FALSE，而 FltSupportsFileContextsEx 會在傳遞實例參數的有效非 NULL 值時傳回 TRUE () 。

如果為 Instance 參數提供非 NULL 值，如果文件系統或篩選管理員支援檔案的檔案內容，FltSupportsFileContextsEx 會傳回 TRUE;否則為 FALSE。

如果 Instance 參數為 NULL，只有在文件系統支援檔案內容的檔案內容時， FltSupportsFileContextsEx 才會傳回 TRUE 。 否則會傳回 FALSE，即使篩選管理員支援檔案的檔案內容也一樣。

請注意，檔案系統可能支援某些檔案類型的檔案內容，但不支援其他文件類型。 例如，NTFS 和 FAT 不支援分頁檔案的檔案內容。

如需內容的詳細資訊，請參閱 關於迷你篩選內容。

規格需求

另請參閱

FltAllocateContext

FltDeleteContext

FltDeleteFileContext

FltGetFileContext

FltReleaseContext

FltSetFileContext

FltSupportsFileContexts