Fonction ReBaseImage (imagehlp.h)

Modifie l’adresse de chargement de l’image spécifiée, ce qui réduit le temps de chargement requis pour une DLL.

Vous pouvez également utiliser l’outil Rebaser. Cet outil est disponible dans Visual Studio et le Kit de développement logiciel (SDK) Windows.

Notez que cette fonction est implémentée en tant qu’appel à la fonction ReBaseImage64 .

Syntaxe

BOOL IMAGEAPI ReBaseImage(
  [in]      PCSTR     CurrentImageName,
  [in]      PCSTR     SymbolPath,
  [in]      BOOL      fReBase,
  [in]      BOOL      fRebaseSysfileOk,
  [in]      BOOL      fGoingDown,
  [in]      ULONG     CheckImageSize,
  [out]     ULONG     *OldImageSize,
  [out]     ULONG_PTR *OldImageBase,
  [out]     ULONG     *NewImageSize,
  [in, out] ULONG_PTR *NewImageBase,
  [in]      ULONG     TimeStamp
);

Paramètres

[in] CurrentImageName

Nom du fichier à rebaser. Vous devez spécifier le chemin d’accès complet au fichier, sauf si le module se trouve dans le répertoire de travail actuel du processus appelant.

[in] SymbolPath

Chemin utilisé pour rechercher le fichier de symboles correspondant. Spécifiez ce chemin pour les images exécutables qui ont des informations symboliques, car lorsque les adresses d’image changent, le fichier de base de données de symboles (PDB) correspondant peut également avoir besoin d’être modifié. Notez que même si le chemin du symbole n’est pas valide, la fonction réussit si elle est en mesure de rebaser votre image.

[in] fReBase

Si cette valeur est TRUE, l’image est redéployée. Sinon, l’image n’est pas rebasée.

[in] fRebaseSysfileOk

Si cette valeur est TRUE, l’image système est rebasée. Sinon, l’image système n’est pas rebasée.

[in] fGoingDown

Si cette valeur est TRUE, l’image peut être rebasée sous la base donnée ; sinon, il ne peut pas.

[in] CheckImageSize

Taille maximale à laquelle l’image peut atteindre, en octets, ou zéro s’il n’y a aucune limite.

[out] OldImageSize

Pointeur vers une variable qui reçoit la taille d’image d’origine, en octets.

[out] OldImageBase

Pointeur vers une variable qui reçoit la base d’image d’origine.

[out] NewImageSize

Pointeur vers une variable qui reçoit la nouvelle taille d’image après l’opération de rebasement, en octets.

[in, out] NewImageBase

Adresse de base à utiliser pour rebasiser l’image. Si l’adresse n’est pas disponible et que le paramètre fGoingDown a la valeur TRUE, la fonction recherche une nouvelle adresse de base et définit ce paramètre sur la nouvelle adresse de base. Si fGoingDown a la valeur FALSE, la fonction recherche une nouvelle adresse de base, mais ne définit pas ce paramètre sur la nouvelle adresse de base.

[in] TimeStamp

Nouvel horodatage de l’en-tête du fichier image. La valeur doit être représentée dans le nombre de secondes écoulées depuis minuit (00:00:00), le 1er janvier 1970, heure universelle coordonnée, selon l’horloge système.

Si ce paramètre est 0, l’horodatage de l’en-tête du fichier actuel est incrémenté de 1 seconde.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Notes

La fonction ReBaseImage modifie l’adresse de charge souhaitée pour l’image spécifiée. Cette opération implique la lecture de l’image entière et la mise à jour de tous les correctifs, des informations de débogage et de la somme de contrôle. Vous pouvez rebaser une image pour réduire le temps de chargement requis pour ses DLL. Si une application peut s’appuyer sur le chargement d’une DLL à l’adresse de charge souhaitée, le chargeur système n’a pas besoin de déplacer l’image. L’image est simplement chargée dans l’espace d’adressage virtuel de l’application et la fonction DllMain est appelée, le cas échéant.

Toutes les fonctions ImageHlp, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.

Vous ne pouvez pas rebasier les DLL qui sont liées à /DYNAMICBASE ou qui résident dans des répertoires protégés, tels que le dossier System32.

En guise d’alternative à l’utilisation de cette fonction, consultez l’option de l’éditeur de liens /BASE .

Configuration requise

Voir aussi

DllMain

Fonctions ImageHlp