fileapi.h) (CREATEFILE2_EXTENDED_PARAMETERS結構

包含 CreateFile2的選擇性擴充參數。

語法

typedef struct _CREATEFILE2_EXTENDED_PARAMETERS {
  DWORD                 dwSize;
  DWORD                 dwFileAttributes;
  DWORD                 dwFileFlags;
  DWORD                 dwSecurityQosFlags;
  LPSECURITY_ATTRIBUTES lpSecurityAttributes;
  HANDLE                hTemplateFile;
} CREATEFILE2_EXTENDED_PARAMETERS, *PCREATEFILE2_EXTENDED_PARAMETERS, *LPCREATEFILE2_EXTENDED_PARAMETERS;

成員

dwSize

包含這個 結構的大小。 sizeof(CREATEFILE2_EXTENDED_PARAMETERS)

dwFileAttributes

檔案或裝置屬性和旗標， FILE_ATTRIBUTE_NORMAL 是檔案最常見的預設值。

此參數可以包含可用檔案屬性的任何組合， (FILE_ATTRIBUTE_*) 。 所有其他檔案屬性都會覆寫 FILE_ATTRIBUTE_NORMAL。

下列部分檔案屬性和旗標只能套用至檔案，不一定是 CreateFile2 可以開啟的所有其他裝置類型。 For additional information, see the Remarks section of the CreateFile2 reference page and Creating and Opening Files.

如需更進階的檔案屬性存取權，請參閱 SetFileAttributes。 如需所有檔案屬性及其值和描述的完整清單，請參閱 檔案屬性常數。

dwFileFlags

此參數可包含旗標 (FILE_FLAG_*) 的組合，以控制檔案或裝置快取行為、存取模式和其他特殊用途旗標。

dwSecurityQosFlags

dwSecurityQosFlags參數會指定 SQOS 資訊。 如需詳細資訊，請參閱 模擬層級。

lpSecurityAttributes

包含兩個個別但相關資料成員 之SECURITY_ATTRIBUTES 結構的指標：選擇性的安全性描述元，以及判斷子進程是否可以繼承傳回控制碼的布林值。

此參數可以是 Null。

如果此參數為 Null，則應用程式可建立的任何子進程無法繼承 CreateFile2 傳回的控制碼，而且與傳回控制碼相關聯的檔案或裝置會取得預設的安全性描述元。

結構的 lpSecurityDescriptor 成員會指定檔案或裝置 的SECURITY_DESCRIPTOR 。 如果這個成員是 Null，則會將與傳回控制碼相關聯的檔案或裝置指派為預設的安全性描述元。

CreateFile2 會在開啟現有的檔案或裝置時忽略 lpSecurityDescriptor 成員，但會繼續使用 bInheritHandle 成員。

結構的 bInheritHandle 成員會指定是否可繼承傳回的控制碼。

如需詳細資訊，請參閱 CreateFile2 主題的一節。

hTemplateFile

具有 GENERIC_READ 存取權限之範本檔案的有效控制碼。 範本檔案會提供所建立檔案的檔案屬性和擴充屬性。

此參數可以是 Null。

開啟現有的檔案時， CreateFile2 會忽略此參數。

開啟新的加密檔案時，檔案會從其父目錄繼承任意存取控制清單。 如需詳細資訊，請參閱 檔案加密。

備註

若要編譯使用 CREATEFILE2_EXTENDED_PARAMETERS 結構的應用程式，請將 _WIN32_WINNT 宏 0x0602 定義為 或更新版本。 如需詳細資訊，請參閱 使用 Windows 標頭。

快取行為

dwFileFlags成員的數個可能值可用來控制或影響與控制碼相關聯的資料如何由系統快取。 其中包括：

• FILE_FLAG_NO_BUFFERING
• FILE_FLAG_RANDOM_ACCESS
• FILE_FLAG_SEQUENTIAL_SCAN
• FILE_FLAG_WRITE_THROUGH
• FILE_ATTRIBUTE_TEMPORARY

如果未指定這些旗標，系統會使用預設的一般用途快取配置。 否則，系統快取的行為會如每個旗標所指定。

其中一些旗標不應該合併。 例如，結合 FILE_FLAG_RANDOM_ACCESS 與 FILE_FLAG_SEQUENTIAL_SCAN 是自我破壞。

指定 FILE_FLAG_SEQUENTIAL_SCAN 旗標可能會提高使用循序存取讀取大型檔案的應用程式效能。 對於大部分循序讀取大型檔案的應用程式，效能提升可能更明顯，但偶爾會略過少量位元組範圍。 如果應用程式移動檔案指標以進行隨機存取，則最可能不會發生最佳快取效能。 不過，仍保證正確作業。

旗 標FILE_FLAG_WRITE_THROUGH 和 FILE_FLAG_NO_BUFFERING 是獨立的，而且可以合併。

如果使用 FILE_FLAG_WRITE_THROUGH 但 未指定FILE_FLAG_NO_BUFFERING ，因此系統快取生效，則資料會寫入系統快取，但不會延遲排清到磁片。

如果同時指定FILE_FLAG_WRITE_THROUGH和FILE_FLAG_NO_BUFFERING，因此系統快取不會生效，則資料會立即排清到磁片，而不會通過 Windows 系統快取。 作業系統也會要求硬碟本機硬體快取的寫入至永續性媒體。

正確使用 FILE_FLAG_NO_BUFFERING 旗標需要特殊應用程式考慮。 如需詳細資訊，請參閱 檔案緩衝。

透過 FILE_FLAG_WRITE_THROUGH 的寫入要求也會造成 NTFS 排清任何中繼資料變更，例如時間戳記更新或重新命名作業，而導致處理要求。 基於這個理由， FILE_FLAG_WRITE_THROUGH 旗標通常會與 FILE_FLAG_NO_BUFFERING 旗標搭配使用，以取代每次寫入之後呼叫 FlushFileBuffers 函式，這可能會導致不必要的效能負面影響。 將這些旗標一起使用可避免這些懲罰。 如需有關檔案和中繼資料快取的一般資訊，請參閱 檔案快取。

當FILE_FLAG_NO_BUFFERING與FILE_FLAG_OVERLAPPED結合時，旗標會提供最大的非同步效能，因為 I/O 不會依賴記憶體管理員的同步作業。 不過，某些 I/O 作業需要更多時間，因為資料不會保留在快取中。 此外，建立空檔案) 時，檔案中繼資料可能仍會快取 (。 若要確保中繼資料已排清到磁片，請使用 FlushFileBuffers 函式。

指定 FILE_ATTRIBUTE_TEMPORARY 屬性會導致檔案系統避免在有足夠的快取記憶體可用時將資料寫回大量儲存體，因為應用程式會在控制碼關閉之後刪除暫存檔。 在此情況下，系統可以完全避免寫入資料。 雖然它不會以與先前提及旗標相同的方式直接控制資料快取， 但FILE_ATTRIBUTE_TEMPORARY 屬性會告知系統在系統快取中盡可能保留，而不會寫入，因此可能會對某些應用程式感到擔心。

同步和非同步 I/O 控制碼

CreateFile2 提供建立同步或非同步檔案或裝置控制碼。 同步控制碼的行為會讓使用該控制碼的 I/O 函式呼叫遭到封鎖，直到完成為止，非同步檔案控制代碼可讓系統立即從 I/O 函式呼叫傳回，無論它們是否完成 I/O 作業。 如先前所述，這個同步與非同步行為是由在pCreateExParams參數中傳遞之 CREATEFILE2_EXTENDED_PARAMETERS結構的dwFileFlags成員內指定FILE_FLAG_OVERLAPPED來決定。 使用非同步 I/O 時，有數個複雜度和潛在陷阱;如需詳細資訊，請參閱 同步和非同步 I/O。

需求

另請參閱

CreateFile2

檔案管理結構