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