SetupCopyErrorA, fonction (setupapi.h)
[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer des pilotes de périphérique.]
La fonction SetupCopyError génère une boîte de dialogue pour avertir un utilisateur d’une erreur de fichier de copie.
Syntaxe
WINSETUPAPI UINT SetupCopyErrorA(
[in] HWND hwndParent,
[in] PCSTR DialogTitle,
[in] PCSTR DiskName,
[in] PCSTR PathToSource,
[in] PCSTR SourceFile,
[in] PCSTR TargetPathFile,
[out] UINT Win32ErrorCode,
[in] DWORD Style,
[in, out] PSTR PathBuffer,
[in] DWORD PathBufferSize,
[in, out] PDWORD PathRequiredSize
);
Paramètres
[in] hwndParent
Handle de la fenêtre parente de cette boîte de dialogue.
[in] DialogTitle
Pointeur facultatif vers une chaîne null-terminated qui spécifie le titre de la boîte de dialogue.
Ce paramètre peut être NULL. Si ce paramètre est null, le titre par défaut de « Erreur de copie » (localisé dans la langue système) est utilisé.
[in] DiskName
Pointeur facultatif vers une chaîne null-terminated qui spécifie le nom du disque à insérer.
Ce paramètre peut être NULL. Si ce paramètre est NULL, le nom par défaut « (inconnu) » (localisé dans la langue système) est utilisé.
[in] PathToSource
Pointeur vers le composant de chemin d’accès du fichier source où une opération échoue, par exemple F :\x86.
Utilisez une chaîne null-terminated.
[in] SourceFile
Pointeur vers une chaîne null-terminated qui spécifie la partie nom de fichier du fichier où une opération échoue.
Utilisez une chaîne null-terminated. Ce nom de fichier s’affiche si l’utilisateur clique sur le Détails ou Parcourir les boutons. La fonction SetupCopyError recherche le fichier qui utilise ses noms de formulaires compressés. Par conséquent, vous pouvez transmettre cmd.exe et ne vous inquiétez pas que le fichier existe réellement en tant que cmd.ex_ sur le média source.
[in] TargetPathFile
Pointeur facultatif vers une chaîne null-terminated qui spécifie le chemin complet du fichier cible pour les opérations de renommage et de copie.
Utilisez une chaîne null-terminated. Ce paramètre peut être NULL. Si TargetPathFile n’est pas spécifié, « (Inconnu) » (localisé dans la langue système) est utilisé.
[out] Win32ErrorCode
Si une erreur se produit, ce membre est le code d’erreur système .
Si une erreur ne se produit pas, elle est NO_ERROR.
[in] Style
Indicateurs qui contrôlent l’affichage de la mise en forme et du comportement d’une boîte de dialogue.
Ce paramètre peut être l’un des indicateurs suivants.
IDF_NOBROWSE
N’affichez pas l’option Parcourir.
IDF_NOSKIP
N’affichez pas l’option ignorer le fichier.
IDF_NODETAILS
N’affichez pas l’option détails.
Si cet indicateur est défini, les paramètres TargetPathFile et Win32ErrorCode peuvent être omis.
IDF_NOCOMPRESSED
Ne recherchez pas les versions compressées du fichier source.
IDF_OEMDISK
La source d’opération est un disque fourni par un fabricant de matériel.
IDF_NOBEEP
Empêche la boîte de dialogue de pleurer pour attirer l’attention de l’utilisateur lors de sa première apparition.
IDF_NOFOREGROUND
Empêche la boîte de dialogue de devenir la fenêtre de premier plan.
IDF_WARNIFSKIP
Avertit l’utilisateur qui ignore un fichier peut affecter l’installation.
[in, out] PathBuffer
Pointeur facultatif vers une variable dans laquelle cette fonction retourne le chemin d’accès (sans inclure le nom de fichier) de l’emplacement spécifié par un utilisateur dans la boîte de dialogue. Vous devez utiliser une chaîne terminée par null.
La chaîne null-terminated ne doit pas dépasser la taille de la mémoire tampon de destination. Pour éviter des erreurs de mémoire tampon insuffisantes, PathBuffer doit être au moins MAX_PATH. Pour plus d’informations, consultez la section Remarques de cette rubrique.
[in] PathBufferSize
Taille de la mémoire tampon qui PathBuffer pointe vers, en caractères.
La taille de la mémoire tampon doit être au moins MAX_PATH caractères, y compris le le point de terminaison null.
[in, out] PathRequiredSize
Pointeur facultatif vers une variable dans laquelle cette fonction retourne la taille de mémoire tampon requise, en caractères, y compris le null terminateur.
Valeur de retour
La fonction retourne l’une des valeurs suivantes.
Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
Si cette fonction est appelée avec un PathBuffer de NULL et un PathBufferSize de 0 (zéro), la fonction place la taille de mémoire tampon nécessaire pour contenir les données spécifiées dans la variable pointée par PathRequiredSize.
Si la fonction réussit, la valeur de retour est NO_ERROR. Sinon, la valeur de retour est l’une des valeurs spécifiées.
Pour éviter des erreurs de mémoire tampon insuffisantes, ReturnBuffer doit être au moins MAX_PATH.
Note
L’en-tête setupapi.h définit SetupCopyError comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | setupapi.h |
| bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |