通过

SetupDefaultQueueCallbackA 函数 （setupapi.h）

  • 项目

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

SetupDefaultQueueCallback 函数是安装程序 API 附带的默认队列回调例程。 可以使用它来处理由 SetupCommitFileQueue 函数发送的通知。

语法

WINSETUPAPI UINT SetupDefaultQueueCallbackA(
  [in] PVOID    Context,
  [in] UINT     Notification,
  [in] UINT_PTR Param1,
  [in] UINT_PTR Param2
);

参数

[in] Context

指向由 SetupInitDefaultQueueCallback 或 SetupInitDefaultQueueCallbackEx 函数初始化的上下文的指针。

[in] Notification

队列操作的通知。 此参数可以是下表中显示的值之一。

价值 意义
SPFILENOTIFY_STARTQUEUE
 已启动排队文件操作。
SPFILENOTIFY_ENDQUEUE
 已完成排队的文件操作。
SPFILENOTIFY_STARTSUBQUEUE
 启动复制、重命名或删除子队列。
SPFILENOTIFY_ENDSUBQUEUE
 完成复制、重命名或删除子队列。
SPFILENOTIFY_STARTRENAME
 启动重命名操作。
SPFILENOTIFY_ENDRENAME
 已完成重命名操作。
SPFILENOTIFY_RENAMEERROR
 重命名文件时遇到错误。
SPFILENOTIFY_STARTDELETE
 启动删除操作。
SPFILENOTIFY_ENDDELETE
 已完成删除操作。
SPFILENOTIFY_DELETEERROR
 删除文件时遇到错误。
SPFILENOTIFY_STARTCOPY
 启动复制操作。
SPFILENOTIFY_ENDCOPY
 完成复制操作。
SPFILENOTIFY_COPYERROR
 复制文件时遇到错误。
SPFILENOTIFY_NEEDMEDIA
 需要新媒体。
SPFILENOTIFY_LANGMISMATCH
 现有目标文件的语言与源不同。
SPFILENOTIFY_TARGETEXISTS
 目标文件存在。
SPFILENOTIFY_TARGETNEWER
现有目标文件比源更新。

[in] Param1

其他消息信息。 此参数的内容取决于 通知 参数的值。

[in] Param2

其他消息信息。 此参数的内容取决于 通知 参数的值。

返回值

返回一个无符号整数，SetupCommitFileQueue，可以是下表中显示的值之一。

返回代码 描述
FILEOP_ABORT
 中止操作。
FILEOP_DOIT
 执行文件操作。
FILEOP_SKIP
 跳过操作。
FILEOP_RETRY
 重试操作。
FILEOP_NEWPATH
 获取操作的新路径。
 

若要获取扩展的错误信息，请调用 GetLastError。

言论

SetupDefaultQueueCallback 函数通常只能通过自定义队列回调例程显式调用。 自定义回调处理队列提交通知的子集，并调用 SetupDefaultQueueCallback 函数来处理其余通知。

有关详细信息，请参阅 队列通知。

注意

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

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 setupapi.h
库 Setupapi.lib
DLL Setupapi.dll
API 集 ext-ms-win-setupapi-classinstallers-l1-1-2（在 Windows 10 版本 10.0.14393 中引入）

另请参阅

Functions

概述

SetupCommitFileQueue