SPFILENOTIFY_NEEDMEDIA message

La notification SPFILENOTIFY_NEEDMEDIA est envoyée à la routine de rappel quand un nouveau média ou un nouveau fichier d’armoire est nécessaire.

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

Paramètres

Param1: Pointeur vers une structure SOURCE_MEDIA .
Param2: Pointeur vers un tableau de caractères pour stocker les nouvelles informations de chemin d’accès fournies par l’utilisateur. La taille de la mémoire tampon est un tableau TCHAR d’éléments MAX_PATH. Les informations de chemin retournées par votre application d’installation ne doivent pas dépasser cette taille.

La routine de rappel doit retourner l’un des éléments suivants.

Code de retour	Description
FILEOP_NEWPATH	Le média est présent et le fichier demandé est disponible au niveau du chemin spécifié dans la mémoire tampon pointée par Param2.
FILEOP_SKIP	Ignorer le fichier demandé
FILEOP_ABORT	Abandonner le traitement de la file d’attente. La fonction SetupCommitFileQueue retourne FALSE. GetLastError retourne des informations d’erreur étendues, telles que ERROR_CANCELLED si l’utilisateur a annulé.
FILEOP-DOIT	Le média est disponible.

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Setupapi.h