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

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

 

 

Show: