SPFILENOTIFY_NEEDMEDIA

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.

Return Values

The callback routine should return one of the following.

Value Meaning
FILEOP_NEWPATH The media is present and the requested file is available at the win32 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.

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, SetupCommitFileQueue, SetupDefaultQueueCallback, SOURCE_MEDIA