共用方式為

KsSetInformationFile 函式 （ks.h）

  • 發行項

KsSetInformationFile 函式會針對指定的檔案物件執行資訊集。 函式會儘可能嘗試使用 FastIoDispatch，或針對裝置對象產生資訊集。

語法

KSDDKAPI NTSTATUS KsSetInformationFile(
  [in] PFILE_OBJECT           FileObject,
  [in] PVOID                  FileInformation,
  [in] ULONG                  Length,
  [in] FILE_INFORMATION_CLASS FileInformationClass
);

參數

[in] FileObject

指定要設定標準資訊的檔案物件。

[in] FileInformation

指出放置檔案資訊的位置。 檔案信息假設為有效或探查的位址。

[in] Length

指定 FileInformation 緩衝區的正確長度。

[in] FileInformationClass

指定要設定的信息類別。

傳回值

KsSetInformationFile 函式會在成功時傳回STATUS_SUCCESS，如果傳回錯誤，則傳回失敗。

言論

KsSetInformationFile 函式只有在設定會導致基礎驅動程式的實際要求時使用，不包括需要將其他參數傳送至驅動程式的複雜作業，例如重新命名、刪除和完成。 例如，FilePositionInformation 不會產生這類要求，因此不應使用。 它假設呼叫端正在串行化對檔案的存取權，以進行對FO_SYNCHRONOUS_IO檔案對象的作業。

要求

要求 價值
目標平臺 普遍
標頭 ks.h （包括 Ks.h）
連結庫 Ks.lib