SPFILENOTIFY_NEEDMEDIA message

The SPFILENOTIFY_NEEDMEDIA notification is sent to the callback routine when new media or a new cabinet file is required.

SPFILENOTIFY_NEEDMEDIA
  Param1 = (UINT) SourceMediaInfo;
  Param2 = (UINT) NewPathInfo;

Parameters

Param1: Pointer to a SOURCE_MEDIA structure.
Param2: Pointer to a character array to store new path information supplied by the user. The buffer size is a TCHAR array of MAX_PATH elements. The path information returned by your setup application should not exceed this size.

The callback routine should return one of the following.

Return code	Description
FILEOP_NEWPATH	The media is present and the requested file is available at the path specified in the buffer pointed to by Param2.
FILEOP_SKIP	Skip the requested file
FILEOP_ABORT	Abort queue processing. The SetupCommitFileQueue function returns FALSE. GetLastError returns extended error information, such as ERROR_CANCELLED if the user canceled.
FILEOP-DOIT	The media is available.

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