Fonction BeginUpdateResourceA (winbase.h)
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 |
Voir aussi
Conceptuel
Référence