Fonction SetupBackupErrorW (setupapi.h)
[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour l’installation d’applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour l’installation des pilotes de périphérique.]
La fonction SetupBackupError génère une boîte de dialogue qui informe l’utilisateur d’une erreur de sauvegarde.
Syntaxe
WINSETUPAPI UINT SetupBackupErrorW(
[in] HWND hwndParent,
[in] PCWSTR DialogTitle,
[in] PCWSTR SourceFile,
[in] PCWSTR TargetFile,
[out] UINT Win32ErrorCode,
[in] DWORD Style
);
Paramètres
[in] hwndParent
Gérer vers la fenêtre parente de cette boîte de dialogue.
[in] DialogTitle
Pointeur facultatif vers une chaîne terminée par null spécifiant le titre de la boîte de dialogue d’erreur. Si ce paramètre a la valeur NULL, le titre par défaut « Erreur de sauvegarde » (localisé) est utilisé.
[in] SourceFile
Pointeur vers une chaîne terminée par null spécifiant le chemin d’accès complet du fichier source en cours de sauvegarde.
[in] TargetFile
Pointeur facultatif vers une chaîne terminée par null spécifiant le chemin d’accès complet du nom de sauvegarde du fichier. Ce paramètre peut être NULL.
[out] Win32ErrorCode
Si une erreur se produit, ce membre est le code d’erreur système. Si aucune erreur ne s’est produite, elle est NO_ERROR.
[in] Style
Les indicateurs qui contrôlent affichent la mise en forme et le comportement de la boîte de dialogue. Ce paramètre peut être l’un des indicateurs suivants.
IDF_NOBEEP
Empêchez la boîte de dialogue de biper pour attirer l’attention de l’utilisateur lorsqu’elle apparaît pour la première fois.
IDF_NOFOREGROUND
Empêchez la boîte de dialogue de devenir la fenêtre de premier plan.
Valeur retournée
Cette fonction retourne l’une des valeurs suivantes.
Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Notes
L’en-tête setupapi.h définit SetupBackupError comme un 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.
Configuration requise
| 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] |
| Plateforme cible | Windows |
| En-tête | setupapi.h |
| Bibliothèque | Setupapi.lib |
| DLL | Setupapi.dll |