SetupInitDefaultQueueCallbackEx 函数 (setupapi.h)

  • 项目

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

SetupInitDefaultQueueCallbackEx 函数以与 SetupInitDefaultQueueCallback 相同的方式初始化安装程序 API 中包含的默认队列回调例程使用的上下文，只不过为回调函数提供了一个接受进度消息的附加窗口。

语法

WINSETUPAPI PVOID SetupInitDefaultQueueCallbackEx(
  [in] HWND  OwnerWindow,
  [in] HWND  AlternateProgressWindow,
  [in] UINT  ProgressMessage,
  [in] DWORD Reserved1,
  [in] PVOID Reserved2
);

参数

[in] OwnerWindow

要用作默认回调例程生成的任何对话框的父对话框的窗口的句柄。

[in] AlternateProgressWindow

接收进度消息的窗口的句柄。 若要防止显示进度消息，可以将此参数指定为INVALID_HANDLE_VALUE。

[in] ProgressMessage

在启动复制队列时以及每次复制文件时发送到 AlternateProgressWindow 的消息。

[in] Reserved1

默认回调例程发送到 AlternateProgressWindow 的第一个消息参数。

[in] Reserved2

由默认回调例程发送到 AlternateProgressWindow 的第二个消息参数。

返回值

SetupInitDefaultQueueCallbackEx 返回指向默认队列回调例程使用的上下文的指针。 仅当内存不足时，此函数才会失败。 如果此函数失败，它将返回 NULL ，并且不会设置线程的最后错误代码。

注解

当队列开始提交复制子队列时，默认队列回调例程会将消息发送到 AlternateProgressWindow 中指定的窗口。 Reserved1 的值为 0， Reserved2 包含指向排队文件复制操作数的指针。

对于完成的每个文件复制操作，默认队列回调例程都会向 AlternateProgressWindow 发送一条消息，该消息可用于“勾选”进度栏。 Reserved1 的值为 1， Reserved2 为零。

SetupInitDefaultQueueCallbackEx 可用于获取磁盘提示、错误处理等的默认行为，并提供嵌入在向导页或其他专用对话框中的仪表。

无论是使用 SetupInitDefaultQueueCallback 还是 SetupInitDefaultQueueCallbackEx 初始化默认队列回调例程使用的上下文，在排队操作完成处理后，调用 SetupTermDefaultQueueCallback 以释放在初始化上下文结构时分配的资源。 有关详细信息，请参阅 初始化和终止回调上下文。

要求

   
最低受支持的客户端 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)

请参阅

函数

概述

SetupInitDefaultQueueCallback