EndUpdateResourceA, fonction (winbase.h)

Article
03/03/2024

Valide ou ignore les modifications apportées avant un appel à UpdateResource.

Syntaxe

BOOL EndUpdateResourceA(
  [in] HANDLE hUpdate,
  [in] BOOL   fDiscard
);

Paramètres

[in] hUpdate

Type : HANDLE

Handle de module retourné par la fonction BeginUpdateResource et utilisé par UpdateResource, référençant le fichier à mettre à jour.

[in] fDiscard

Type : BOOL

Indique s’il faut écrire les mises à jour de ressources dans le fichier. Si ce paramètre a la valeur TRUE, aucune modification n’est apportée. Si la valeur est FALSE, les modifications sont apportées : les mises à jour des ressources prendront effet.

Valeur retournée

Type : BOOL

Retourne TRUE si la fonction réussit ; FALSE dans le cas contraire. Si la fonction réussit et que fDiscard a la valeur TRUE, aucune mise à jour des ressources n’est apportée au fichier ; sinon, toutes les mises à jour de ressources réussies sont effectuées dans le fichier. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Avant d’appeler cette fonction, assurez-vous que tous les descripteurs de fichiers autres que ceux retournés par BeginUpdateResource sont fermés.

Cette fonction peut mettre à jour des ressources dans des modules qui contiennent à la fois du code et des ressources. Il existe des restrictions sur les mises à jour des ressources dans les fichiers LN et les fichiers .mui, qui contiennent tous deux des données de configuration des ressources ; les détails des restrictions figurent dans la référence pour la fonction UpdateResource .

Exemples

Pour obtenir un exemple, consultez Mise à jour des ressources.

Notes

L’en-tête winbase.h définit EndUpdateResource 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 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll