共用方式為

SetupAddToDiskSpaceListW 函式 (setupapi.h)

  • 發行項

[此函式可用於需求一節中所述的操作系統。 它在後續版本中可能會變更或無法使用。 安裝程式API不應再用於安裝應用程式。 請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]

SetupAddToDiskSpaceList 函式會將單一刪除或複製作業新增至磁碟空間清單。 若要在 INF 檔案的區段中新增所有檔案作業，請使用 SetupAddSectionToDiskSpaceList 或 SetupAddInstallSectionToDiskSpaceList。

此函式會忽略目標磁碟壓縮。 系統會假設檔案佔用目標磁碟上的完整大小。

語法

WINSETUPAPI BOOL SetupAddToDiskSpaceListW(
  [in] HDSKSPC  DiskSpace,
  [in] PCWSTR   TargetFilespec,
  [in] LONGLONG FileSize,
  [in] UINT     Operation,
  [in] PVOID    Reserved1,
  [in] UINT     Reserved2
);

參數

[in] DiskSpace

磁碟空間清單的句柄。

[in] TargetFilespec

要新增至磁碟空間清單的檔名。 您應該使用以 Null 結尾的字串來指定完整路徑。 否則，路徑必須相對於當前目錄。

[in] FileSize

檔案的解壓縮大小，因為檔案會存在於目標目錄中，以位元組為單位。 您可以使用 SetupGetSourceFileSize 從 INF 檔案擷取此資訊。 FILEOP_DELETE作業會忽略此參數。

[in] Operation

要新增至清單的檔案作業。 此參數可以是下列其中一個值。

值 意義
FILEOP_DELETE
 檔案刪除作業。
FILEOP_COPY。
 檔案複製作業。

[in] Reserved1

必須為零。

[in] Reserved2

必須為零。

傳回值

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

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

備註

注意

setupapi.h 標頭會將 SetupAddToDiskSpaceList 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 setupapi.h
程式庫 Setupapi.lib
Dll Setupapi.dll

請參閱

函式

概觀