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 was encountered, continue processing the cabinet. |
|
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 |
|