SetupDefaultQueueCallbackA 函数 (setupapi.h)

  • 项目

[此函数可用于“要求”部分所示的操作系统。 它可能在后续版本中变更或不可用。 安装程序API 不应再用于安装应用程序。 请改用 Windows 安装程序来开发应用程序安装程序。 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

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

[in] Param2

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

返回值

向 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 [仅限桌面应用]
目标平台 Windows
标头 setupapi.h
Library Setupapi.lib
DLL Setupapi.dll
API 集 Windows 10版本 10.0.1439 (3 中引入的 ext-ms-win-setupapi-classinstallers-l1-1-2)

请参阅

函数

概述

SetupCommitFileQueue