Freigeben über


SPFILENOTIFY_NEEDMEDIA Nachricht

Die SPFILENOTIFY_NEEDMEDIA Benachrichtigung wird an die Rückrufroutine gesendet, wenn neue Medien oder eine neue Ablagedatei erforderlich ist.

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

Parameter

Param1

Zeiger auf eine SOURCE_MEDIA-Struktur .

Param2

Zeiger auf ein Zeichenarray zum Speichern neuer Pfadinformationen, die vom Benutzer bereitgestellt werden. Die Puffergröße ist ein TCHAR-Array von MAX_PATH Elementen. Die von Der Setupanwendung zurückgegebenen Pfadinformationen sollten diese Größe nicht überschreiten.

Rückgabewert

Die Rückrufroutine sollte eine der folgenden Rückgaben ausführen.

Rückgabecode Beschreibung
FILEOP_NEWPATH
Das Medium ist vorhanden, und die angeforderte Datei ist unter dem Pfad verfügbar, der im Puffer angegeben ist, auf den von Param2 verwiesen wird.
FILEOP_SKIP
Überspringen der angeforderten Datei
FILEOP_ABORT
Abbrechen der Warteschlangenverarbeitung. Die SetupCommitFileQueue-Funktion gibt FALSE zurück. GetLastError gibt erweiterte Fehlerinformationen zurück, z. B. ERROR_CANCELLED, wenn der Benutzer abgebrochen hat.
FILEOP-DOIT
Die Medien sind verfügbar.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Header
Setupapi.h

Weitere Informationen

Übersicht

Benachrichtigungen

SetupCommitFileQueue

SetupDefaultQueueCallback

SOURCE_MEDIA