Fonction BeginUpdateResourceA (winbase.h)

Article
08/27/2023

Récupère un handle qui peut être utilisé par la fonction UpdateResource pour ajouter, supprimer ou remplacer des ressources dans un module binaire.

Syntaxe

HANDLE BeginUpdateResourceA(
  [in] LPCSTR pFileName,
  [in] BOOL   bDeleteExistingResources
);

Paramètres

[in] pFileName

Type : LPCTSTR

Fichier binaire dans lequel mettre à jour les ressources. Une application doit pouvoir obtenir un accès en écriture à ce fichier ; le fichier référencé par pFileName ne peut pas être en cours d’exécution. Si pFileName ne spécifie pas de chemin d’accès complet, le système recherche le fichier dans le répertoire actif.

[in] bDeleteExistingResources

Type : BOOL

Indique s’il faut supprimer les ressources existantes du paramètre pFileName . Si ce paramètre a la valeur TRUE, les ressources existantes sont supprimées et le fichier mis à jour inclut uniquement les ressources ajoutées avec la fonction UpdateResource . Si ce paramètre a la valeur FALSE, le fichier mis à jour inclut des ressources existantes, sauf si elles sont explicitement supprimées ou remplacées à l’aide de UpdateResource.

Valeur retournée

Type : HANDLE

Si la fonction réussit, la valeur de retour est un handle qui peut être utilisé par les fonctions UpdateResource et EndUpdateResource . La valeur de retour est NULL si le fichier spécifié n’est pas un PE, si le fichier n’existe pas ou si le fichier ne peut pas être ouvert pour écriture. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Il est recommandé de ne pas charger le fichier de ressources avant l’appel de cette fonction. Toutefois, si ce fichier est déjà chargé, il n’entraîne pas de retour d’erreur.

Il existe certaines restrictions sur les mises à jour des ressources dans les fichiers qui contiennent des données configuration des ressources (configuration RC) : les fichiers LN et les fichiers .mui associés. Pour plus d’informations sur les types de ressources autorisés à être mis à jour dans ces fichiers, consultez la section Remarques de la fonction UpdateResource .

Cette fonction peut mettre à jour des ressources dans des modules qui contiennent à la fois du code et des ressources. Comme indiqué ci-dessus, 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 RC Config ; 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 BeginUpdateResource 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


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