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.

Return value

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.

Requirements

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

See also

Overview

Notifications

SetupCommitFileQueue

SetupDefaultQueueCallback

SOURCE_MEDIA