FlushViewOfFile 函式 (memoryapi.h)

發行項
02/28/2024

寫入檔案對應檢視內的位元組範圍磁碟。

語法

BOOL FlushViewOfFile(
  [in] LPCVOID lpBaseAddress,
  [in] SIZE_T  dwNumberOfBytesToFlush
);

參數

[in] lpBaseAddress

要排清至對應檔案之磁碟表示之位元組範圍的基地址指標。

[in] dwNumberOfBytesToFlush

要排清的位元組數目。如果 dwNumberOfBytesToFlush 為零，則會從基位址排清檔案到對應結尾。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

排清對應檢視的範圍會起始將該範圍內已變更的頁面寫入磁碟。已變更的頁面是自從對應檔案檢視后的內容已變更的頁面。 FlushViewOfFile 函式不會排清檔案元數據，而且在從基礎硬體磁碟快取排清變更並實際寫入磁碟之前，不會等待傳回。若要排清所有已變更的頁面加上檔案的元數據，並確定它們實際寫入磁碟，請呼叫 FlushViewOfFile ，然後呼叫 FlushFileBuffers 函式。

透過網路排清記憶體對應檔案時， FlushViewOfFile 可確保數據已從本機電腦寫入，但數據不在遠端電腦上。伺服器可以在遠端快取數據。因此， FlushViewOfFile 可以在數據實際寫入磁碟之前傳回。

透過對應檢視修改檔案時，可能不會自動更新上次修改時間戳。如有需要，呼叫端應該使用 SetFileTime 來設定時間戳。

在 Windows Server 2012 中，下列技術支援此函式。

技術	支援
伺服器消息塊 (SMB) 3.0 通訊協定	Yes
SMB 3.0 透明故障轉移 (TFO)	Yes
具有向外延展檔案共用的SMB 3.0 (SO)	Yes
叢集共用磁碟區文件系統 (CsvFS)	Yes
彈性檔案系統 (ReFS)	Yes

當 CSVF 暫停時，此呼叫可能會失敗，並出現錯誤，指出發生鎖定衝突。

範例

如需範例，請參閱從檔案檢視讀取和寫入。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	memoryapi.h (包括 Windows.h、Memoryapi.h)
程式庫	onecore.lib
DLL	Kernel32.dll