SPFILENOTIFY_NEEDNEWCABINET message

The SPFILENOTIFY_NEEDNEWCABINET notification is sent by SetupIterateCabinet to indicate that the current file continues in another cabinet. Your callback routine can then call SetupPromptForDisk, or create its own dialog box to prompt the user to insert the next disk.

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

Parameters

Param1

Pointer to a CABINET_INFO structure that contains information about the cabinet and the file to be extracted.

Param2

If the callback returns NO_ERROR, this parameter is a pointer to a null-terminated string. If the string is not empty, it specifies a new path to the cabinet.

Return value

Your routine should return one of the following values.

Return code	Description
NO_ERROR	No error was encountered, continue processing the cabinet.
ERROR_XXX	An error of the specified type occurred. The SetupIterateCabinet function will return FALSE, and the specified error code will be returned by a call to GetLastError.

Note

There is no default cabinet callback routine; thus, you must supply a callback routine to handle the notifications sent by SetupIterateCabinet.

Remarks

If the callback routine returns NO_ERROR, SetupIterateCabinet checks the buffer pointed to by Param2. If the buffer is not empty, then it contains a new source path. If the buffer is empty, the source path is assumed to be unchanged.

Your callback function should ensure that the cabinet is accessible before it returns, calling the SetupPromptForDisk function, if new media needs to be inserted.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	Setupapi.h

See also

Overview

Notifications

CABINET_INFO

SetupIterateCabinet