SetupBackupErrorA, fonction (setupapi.h)

Article
08/26/2023

[Cette fonction peut être utilisée 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 installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer les 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 SetupBackupErrorA(
  [in]  HWND  hwndParent,
  [in]  PCSTR DialogTitle,
  [in]  PCSTR SourceFile,
  [in]  PCSTR TargetFile,
  [out] UINT  Win32ErrorCode,
  [in]  DWORD Style
);

Paramètres

[in] hwndParent

Gérez la fenêtre parente pour 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 un caractère 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

Indicateurs qui contrôlent la mise en forme et le comportement de l’affichage 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 bips pour attirer l’attention de l’utilisateur lorsqu’elle s’affiche pour la première fois.

IDF_NOFOREGROUND

Empêcher 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 en tant qu’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. La combinaison 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


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