Fonction SetupDeleteErrorA (setupapi.h)

Article
03/01/2024

[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 SetupDeleteError génère une boîte de dialogue qui informe l’utilisateur d’une erreur de suppression.

Syntaxe

WINSETUPAPI UINT SetupDeleteErrorA(
  [in]  HWND  hwndParent,
  [in]  PCSTR DialogTitle,
  [in]  PCSTR File,
  [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 suppression » (localisé) est utilisé.

[in] File

Pointeur vers une chaîne terminée par null spécifiant le chemin d’accès complet du fichier sur lequel l’opération de suppression a échoué.

[out] Win32ErrorCode

Code d’erreur système rencontré pendant l’opération de fichier.

[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 SetupDeleteError 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