IoCheckQuerySetFileInformation 函式 (ntifs.h)
IoCheckQuerySetFileInformation 例程會檢查查詢或設定檔案資訊作業的參數有效性。
語法
NTSTATUS IoCheckQuerySetFileInformation(
FILE_INFORMATION_CLASS FileInformationClass,
ULONG Length,
BOOLEAN SetOperation
);
參數
FileInformationClass
FILE_INFORMATION_CLASS列舉值,指定要檢查的檔案信息類別。
Length
指定檔案資訊作業所需的緩衝區大小,以位元組為單位。
SetOperation
指定作業類型的布爾值。 如果 SetOperation 為 TRUE,則作業為集合檔案作業;如果 為 FALSE, 則為查詢檔案作業。
傳回值
如果參數有效,IoCheckQuerySetFileInformation 會傳回STATUS_SUCCESS;否則,它會傳回下列其中一個錯誤碼。
傳回碼 | Description |
---|---|
STATUS_INVALID_INFO_CLASS | FileInformationClass 中指定的值不是有效的信息類別。 |
STATUS_INFO_LENGTH_MISMATCH | 在 Length 中指定的緩衝區大小小於指定之檔案作業所需的緩衝區大小。 |
備註
IoCheckQuerySetFileInformation 主要是由在核心模式中執行的網路伺服器使用,因為正常路徑中沒有這類參數有效性檢查。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | ntifs.h (包含 Ntifs.h) |