SetupRemoveSectionFromDiskSpaceListA 函数 (setupapi.h)

  • 项目

[此函数可用于“要求”部分所示的操作系统。 它可能在后续版本中变更或不可用。 安装程序API 不应再用于安装应用程序。 请改用 Windows 安装程序来开发应用程序安装程序。 SetupAPI 继续用于安装设备驱动程序。]

SetupRemoveSectionFromDiskSpaceList 函数从磁盘空间列表中删除 INF 文件的“复制文件”部分中列出的文件删除或复制操作。

语法

WINSETUPAPI BOOL SetupRemoveSectionFromDiskSpaceListA(
  [in] HDSKSPC DiskSpace,
  [in] HINF    InfHandle,
  [in] HINF    ListInfHandle,
  [in] PCSTR   SectionName,
  [in] UINT    Operation,
  [in] PVOID   Reserved1,
  [in] UINT    Reserved2
);

参数

[in] DiskSpace

磁盘空间列表的句柄。

[in] InfHandle

包含 SourceDisksFiles 节的打开 INF 文件的句柄。 如果未指定 ListInfHandle ，则此 INF 文件还必须包含 SectionName 指定的节。

[in] ListInfHandle

打开的 INF 文件的可选句柄，其中包含要从磁盘空间列表中删除的部分。 否则， InfHandle 必须包含 SectionName 指定的节。

[in] SectionName

指向以 null 结尾的字符串的指针，该字符串指定要从磁盘空间列表中删除的 “复制文件 ”或“ 删除文件” 部分的名称。

[in] Operation

要从列表中删除的文件操作。 此参数的取值可为下列值之一：

值 含义
FILEOP_DELETE
 文件删除操作。
FILEOP_COPY
 文件复制操作。

[in] Reserved1

必须为零。

[in] Reserved2

必须为零。

返回值

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

注解

SetupRemoveSectionFromDiskSpaceList 函数删除的文件操作通常是使用 SetupAddSectionToDiskSpaceList 函数添加到列表的文件操作，但这不是一项要求。 SetupRemoveSectionFromDiskSpaceList 函数忽略 INF 节中未在磁盘空间列表中列出的文件。

此函数需要 Windows INF 文件。 某些较旧的 INF 文件格式可能不受支持。

注意

setupapi.h 标头将 SetupRemoveSectionFromDiskSpaceList 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 setupapi.h
Library Setupapi.lib
DLL Setupapi.dll

请参阅

函数

概述

SetupAddSectionToDiskSpaceList

SetupRemoveFromDiskSpaceList

SetupRemoveInstallSectionFromDiskSpaceList