SPFILENOTIFY_NEEDNEWCABINET消息

SPFILENOTIFY_NEEDNEWCABINET通知由 SetupIterateCabinet 发送,指示当前文件继续在另一个文件柜中。 然后,回调例程可以调用 SetupPromptForDisk,或创建其自己的对话框来提示用户插入下一个磁盘。

SPFILENOTIFY_NEEDNEWCABINET
  Param1 = (UINT) CabinetInfo;
  Param2 = (UINT) NewPath;
            

parameters

Param1

指向 CABINET_INFO 结构的指针,该结构包含有关要提取的文件柜和文件的信息。

Param2

如果回调返回NO_ERROR,则此参数是指向以 null 结尾的字符串的指针。 如果字符串不为空,则指定到文件柜的新路径。

返回值

例程应返回以下值之一。

返回代码 说明
NO_ERROR
未遇到任何错误,请继续处理文件柜。
ERROR_XXX
发生指定类型的错误。 SetupIterateCabinet 函数将返回 FALSE,指定的错误代码将通过调用 GetLastError 返回。

注意

没有默认的内阁回调例程;因此,必须提供回调例程来处理 SetupIterateCabinet 发送的通知。

备注

如果回调例程返回NO_ERROR, 则 SetupIterateCabinet 会检查 Param2 指向的缓冲区。 如果缓冲区不为空,则它包含新的源路径。 如果缓冲区为空,则假定源路径保持不变。

如果需要插入新媒体,则回调函数应确保在文件柜返回之前可访问,并调用 SetupPromptForDisk 函数。

要求

要求
最低受支持的客户端
Windows XP [仅限桌面应用]
最低受支持的服务器
Windows Server 2003 [仅限桌面应用]
标头
Setupapi.h

请参阅

概述

通知

CABINET_INFO

SetupIterateCabinet