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)

另請參閱

FILE_INFORMATION_CLASS

ZwQueryInformationFile

ZwSetInformationFile