Export (0) Print
Expand All

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 codeDescription
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

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Setupapi.h

See Also

Overview
Notifications
CABINET_INFO
SetupIterateCabinet

 

 

Build date: 8/19/2010

Community Additions

ADD
Show:
© 2014 Microsoft