初始化和终止回调上下文

在可以使用默认队列回调例程之前,要么在提交文件队列时将其指定为回调例程,要么通过从自定义回调例程调用它,它必须初始化。

SetupInitDefaultQueueCallback 函数生成默认队列回调例程使用的上下文结构。 它返回指向该结构的 void 指针。 此结构对于默认回调例程的操作至关重要,必须传递给回调例程。 为此,可以在调用 SetupCommitFileQueue 时将 void 指针指定为上下文,或者在从自定义回调例程调用 SetupDefaultQueueCallback 时将 void 指针指定为上下文参数。 安装应用程序不得更改或引用此上下文结构。

SetupInitDefaultQueueCallbackEx 函数还初始化默认队列回调例程的上下文,但它指定第二个窗口,以便在队列每次发送通知时接收调用方指定的进度消息。 这样,便可以使用默认磁盘提示和错误对话框,并在第二个窗口中嵌入进度栏,例如,在安装向导的页中。

无论是使用 SetupInitDefaultQueueCallback 还是 SetupInitDefaultQueueCallbackEx 初始化默认队列回调例程使用的上下文,在排队操作完成处理后,调用 SetupTermDefaultQueueCallback 以释放在初始化上下文结构时分配的资源。