SPFILENOTIFY_NEEDNEWCABINET

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.

QuickInfo

  Windows NT: Use version 4.0 and later.
  Windows: Use Windows 95 and later.
  Windows CE: Unsupported.
  Header: Declared in setupapi.h.

See Also

Overview, Notifications, CABINET_INFO, SetupIterateCabinet