SPFILENOTIFY_NEEDNEWCABINET
[New
- Windows NT]
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 Values
Your routine
should return one of the following values.
|
Value |
Meaning |
|
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.
See Also