SetupBackupErrorA, fonction (setupapi.h)

Article
11/20/2024

[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 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 de cette boîte de dialogue.

[in] DialogTitle

Pointeur facultatif vers une chaîne null-terminated spécifiant le titre de la boîte de dialogue d’erreur. Si ce paramètre est NULL, le titre par défaut de « Erreur de sauvegarde » (localisé) est utilisé.

[in] SourceFile

Pointeur vers une chaîne null-terminated spécifiant le chemin d’accès complet du fichier source sauvegardé.

[in] TargetFile

Pointeur facultatif vers une chaîne null-terminated 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 n’a eu lieu, elle est NO_ERROR.

[in] Style

Indicateurs qui contrôlent 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 pleurer pour attirer l’attention de l’utilisateur lors de sa première apparition.

IDF_NOFOREGROUND

Empêcher la boîte de dialogue de devenir la fenêtre de premier plan.

Valeur de retour

Cette fonction retourne l’une des valeurs suivantes.

Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Note

L’en-tête setupapi.h définit SetupBackupError 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