SPFILENOTIFY_NEEDNEWCABINET message
La notification SPFILENOTIFY_NEEDNEWCABINET est envoyée par SetupIterateCabinet pour indiquer que le fichier actuel se poursuit dans une autre armoire. Votre routine de rappel peut ensuite appeler SetupPromptForDisk ou créer sa propre boîte de dialogue pour inviter l’utilisateur à insérer le disque suivant.
SPFILENOTIFY_NEEDNEWCABINET
Param1 = (UINT) CabinetInfo;
Param2 = (UINT) NewPath;
Paramètres
-
Param1
-
Pointeur vers une structure CABINET_INFO qui contient des informations sur l’armoire et le fichier à extraire.
-
Param2
-
Si le rappel retourne NO_ERROR, ce paramètre est un pointeur vers une chaîne terminée par null. Si la chaîne n’est pas vide, elle spécifie un nouveau chemin d’accès à l’armoire.
Valeur retournée
Votre routine doit retourner l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
Aucune erreur n’a été rencontrée, poursuivez le traitement de l’armoire. |
|
Une erreur du type spécifié s’est produite. La fonction SetupIterateCabinet retourne FALSE et le code d’erreur spécifié est retourné par un appel à GetLastError. |
Notes
Il n’existe aucune routine de rappel d’armoire par défaut ; par conséquent, vous devez fournir une routine de rappel pour gérer les notifications envoyées par SetupIterateCabinet.
Notes
Si la routine de rappel retourne NO_ERROR, SetupIterateCabinet vérifie la mémoire tampon pointée vers Param2. Si la mémoire tampon n’est pas vide, elle contient un nouveau chemin d’accès source. Si la mémoire tampon est vide, le chemin d’accès source est supposé être inchangé.
Votre fonction de rappel doit s’assurer que l’armoire est accessible avant qu’elle ne retourne, en appelant la fonction SetupPromptForDisk , si un nouveau média doit être inséré.
Spécifications
| 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 |
|