SetupAddToDiskSpaceListA 函式 （setupapi.h）

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

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

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

語法

WINSETUPAPI BOOL SetupAddToDiskSpaceListA(
  [in] HDSKSPC  DiskSpace,
  [in] PCSTR    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 標頭會根據 UNICODE 預處理器常數的定義，將 SetupAddToDiskSpaceList 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	setupapi.h
連結庫	Setupapi.lib
DLL	Setupapi.dll

另請參閱

函式

概觀