BeginUpdateResourceW, fonction (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 BeginUpdateResourceW(
[in] LPCWSTR pFileName,
[in] BOOL bDeleteExistingResources
);
Paramètres
[in] pFileName
Type : LPCTSTR
Fichier binaire dans lequel mettre à jour les ressources. Une application doit être en mesure d’obtenir l’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 est 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 est FALSE, le fichier mis à jour inclut des ressources existantes, sauf si elles sont explicitement supprimées ou remplacées à l’aide de UpdateResource.
Valeur de retour
Type : HANDLE
Si la fonction réussit, la valeur de retour est un handle qui peut être utilisé par les fonctions UpdateResource
Remarques
Il est recommandé que le fichier de ressources ne soit pas chargé avant l’appel de cette fonction. Toutefois, si ce fichier est déjà chargé, il n’entraîne pas de retour d’erreur.
Certaines restrictions s’appliquent aux mises à jour des ressources dans les fichiers qui contiennent des données Resource Configuration(RC Config) : fichiers LN et fichiers .mui associés. Les détails sur les types de ressources autorisés à être mis à jour dans ces fichiers figurent dans la section Remarques pour la fonction UpdateResource.
Cette fonction peut mettre à jour des ressources au sein des modules qui contiennent 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, dont les deux contiennent des données RC Config ; les détails des restrictions sont dans la référence de la fonction UpdateResource.
Exemples
Pour obtenir un exemple, consultez mise à jour des ressources.
Note
L’en-tête winbase.h définit BeginUpdateResource 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 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winbase.h (inclure Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |
Voir aussi
conceptuelle
de référence