Partager via

SPFILENOTIFY_NEEDNEWCABINET message

  • Article

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
NO_ERROR
 Aucune erreur n’a été rencontrée, poursuivez le traitement de l’armoire.
ERROR_XXX
 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
Setupapi.h

Voir aussi

Présentation

Notifications

CABINET_INFO

SetupIterateCabinet