SetupRenameErrorA, fonction (setupapi.h)
[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 RenameError génère une boîte de dialogue qui informe l’utilisateur d’une erreur de renommage 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 pour cette boîte de dialogue.
[in] DialogTitle
Pointeur vers une chaîne terminée par null qui spécifie le titre de la boîte de dialogue d’erreur. Ce paramètre peut être NULL. Si ce paramètre a la valeur NULL, le titre par défaut « Erreur de renommage » (localisé) est utilisé.
[in] SourceFile
Pointeur vers une chaîne terminée par null 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 terminée par null qui spécifie le chemin d’accès complet du fichier cible sur lequel l’opération a échoué.
[in] Win32ErrorCode
Code d’erreur système rencontré pendant l’opération de fichier.
[in] Style
Spécifie la mise en forme d’affichage et le comportement de la boîte de dialogue. Ce paramètre peut être l’un des indicateurs suivants.
IDF_NOBEEP
Empêcher la boîte de dialogue de bips 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 SetupRenameError 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
| 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 |