共用方式為

SetupCreateDiskSpaceListA 函式 （setupapi.h）

  • 發行項

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

SetupCreateDiskSpaceList 函式會建立磁碟空間清單。

語法

WINSETUPAPI HDSKSPC SetupCreateDiskSpaceListA(
  [in] PVOID Reserved1,
  [in] DWORD Reserved2,
  [in] UINT  Flags
);

參數

[in] Reserved1

未使用，必須是零。

[in] Reserved2

未使用，必須是零。

[in] Flags

此參數可以是下列值。

SPDSL_IGNORE_DISK

新增至清單的檔案作業將會忽略磁碟上已經存在的檔案。 例如，如果磁碟包含 5000 位元組的檔案 C：\MyDir\MyFile，並將複製作業新增至新版本的磁碟空間清單 C：\MyDir\MyFile，也就是 6500 個字節，所需的空間會是 6500 個字節（而不是 1500 個字節，如果您未設定SPDSL_IGNORE_DISK，則會傳回此值）。

傳回值

如果函式成功，它會將句柄傳回給磁碟空間清單。

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

言論

注意

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

要求

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

另請參閱

函式

概觀

SetupDestroyDiskSpaceList