IoCheckQuerySetFileInformation 例程會檢查查詢或設定檔案資訊作業的參數有效性。
語法
NTSTATUS IoCheckQuerySetFileInformation(
FILE_INFORMATION_CLASS FileInformationClass,
ULONG Length,
BOOLEAN SetOperation
);
參數
FileInformationClass
FILE_INFORMATION_CLASS 列舉值，指定要檢查的檔案信息類別。
Length
指定檔案資訊作業所需的緩衝區大小，以位元組為單位。
SetOperation
指定作業類型的布爾值。 如果 SetOperation 為 TRUE ，則作業為 set file 作業;如果 FALSE， 它是查詢檔案作業。
傳回值
如果參數有效，IoCheckQuerySetFileInformation 會傳回STATUS_SUCCESS;否則，它會傳回下列其中一個錯誤碼。
| 傳回碼 | 描述 |
|---|---|
| STATUS_INVALID_INFO_CLASS | FileInformationClass 中指定的值不是有效的資訊類別。 |
| STATUS_INFO_LENGTH_MISMATCH | Length 中指定的緩衝區大小小於指定檔案作業所需的緩衝區大小。 |
言論
IoCheckQuerySetFileInformation 主要是由在核心模式中執行的網路伺服器使用，因為一般路徑中不會進行這類參數有效性檢查。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 窗戶 |
| 標頭 | ntifs.h （include Ntifs.h） |