SetupRenameErrorA, 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 RenameError génère une boîte de dialogue qui informe l’utilisateur d’une erreur de changement de nom de fichier.
Syntaxe
WINSETUPAPI UINT SetupRenameErrorA(
[in] HWND hwndParent,
[in] PCSTR DialogTitle,
[in] PCSTR SourceFile,
[in] PCSTR TargetFile,
[in] UINT Win32ErrorCode,
[in] DWORD Style
);
Paramètres
[in] hwndParent
Gérez la fenêtre parente de cette boîte de dialogue.
[in] DialogTitle
Pointeur vers une chaîne null-terminated qui spécifie le titre de la boîte de dialogue d’erreur. Ce paramètre peut être NULL. Si ce paramètre est NULL, le titre par défaut de « Renommer l’erreur » (localisé) est utilisé.
[in] SourceFile
Pointeur vers une chaîne null-terminated qui spécifie le chemin d’accès complet du fichier source sur lequel l’opération a échoué.
[in] TargetFile
Pointeur vers une chaîne null-terminated qui spécifie le chemin complet du fichier cible sur lequel l’opération a échoué.
[in] Win32ErrorCode
Le code d’erreur système rencontré pendant l’opération de fichier.
[in] Style
Spécifie 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 lorsqu’elle apparaît pour la première fois.
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 SetupRenameError 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 |