Configuration CodeGuard

Remonter à Menu Outils

Outils > Configuration CodeGuard

Utilisez la boîte de dialogue Configuration CodeGuard pour spécifier le comportement du débogueur d'exécution CodeGuard. Vous pouvez invoquer cette boîte de dialogue en exécutant l'utilitaire cgconfig.exe, disponible dans l'installation de votre produit. Si vous changez des paramètres CodeGuard dans la boîte de dialogue Configuration CodeGuard, CodeGuard génère un fichier de configuration .cgi avec le même nom et le même répertoire que votre fichier projet.

Remarque : CodeGuard est disponible seulement pour les projets C++.

Elément	Description
Activer (CodeGuard)	Active ou désactive CodeGuard.
Fréquence de remplissage de la pile	Spécifie à quelle fréquence CodeGuard remplit la portion non initialisée de la pile d'exécution avec une séquence d'octets unique. Les valeurs sont les suivantes : -1 = Jamais 0 = Après chaque appel à une fonction d'exécution couverte par CodeGuard. n [0...15] = Après 2^n appels à une fonction d'exécution couverte par CodeGuard. Par exemple, si n vaut 1, la pile est remplie une fois sur deux qu'une fonction d'exécution est appelée.
Statistiques	Signale les statistiques d'utilisation des fonctions et des ressources.
Pertes de ressources	Signale les pertes de ressources détectées à la fin de l'exécution de l'application.
Envoyer vers OutputDebugString	Utilise la fonction OutputDebugString pour envoyer des messages CodeGuard à un débogueur externe.
Ajouter au journal	Ajoute le journal des erreurs au journal existant. Quand cette option est désactivée, CodeGuard écrit par-dessus le journal des erreurs existant.
Erreurs répétées	Signale les erreurs qui se produisent de manière répétitive par fonction.
Limiter le nombre de messages d'erreurs	Limite le nombre d'erreurs signalées. Vous pouvez spécifier une valeur maximale de 65 535.
Activer (Boîte de message d'erreur)	Active la boîte de message d'erreur. Si vous exécutez une application avec CodeGuard activé hors de RAD Studio, la boîte de message d'erreur s'affiche lorsque des erreurs d'exécution se produisent.
Titre	Spécifie le texte qui apparaît dans la barre de titre.
Message	Spécifie le message d'erreur à afficher.
Lire les infos de débogage	Demande à CodeGuard d'utiliser les informations de débogage de votre projet pour pointer sur une ligne source lorsqu'une erreur d'exécution est signalée.
Chemin source	Si le code source se trouve à un emplacement différent de celui de l'exécutable, spécifiez le chemin (ou les chemins séparés par des points-virgules). CodeGuard examine d'abord son propre chemin source de débogage, puis (s'il s'exécute dans l'EDI) le chemin source de débogage de l'EDI.

Options de ressources

Utilisez la page Options de ressources pour spécifier comment CodeGuard couvre les divers types de ressources.

Elément	Description
Ressources	Liste les types de ressources que CodeGuard peut couvrir, comme suit : bloc mémoire - Mémoire gérée par les fonctions malloc et free. objet - Mémoire gérée par les opérateurs new et delete. tableau d'objets - Mémoire gérée par les opérateurs new[] et delete[]. handle de fichier - Un fichier géré par les fonctions open et close. flux fichier - Un fichier géré par les fonctions fopen et fclose. flux pipe - Un canal de processeur de commandes géré par les fonctions _popen et _pclose. flux répertoire - Un répertoire géré par les fonctions opendir et closedir.
Activer le suivi	Active le suivi de la ressource sélectionnée. Désactiver le suivi entraîne une utilisation moindre de la mémoire et une exécution plus rapide.
Suivre les pertes de ressources	Signale les allocations de ressources pour lesquelles il n'y a pas de désallocations correspondantes. Par exemple, il est possible de provoquer une perte en ne réussissant pas à libérer un handle de fichier avant la terminaison du programme.
Rapporter les paramètres handle / ressource incorrects	Signale l'utilisation incorrecte des ressources dans les arguments de fonctions.
Retarder la libération	Suit la ressource sélectionnée après sa désallocation. Lorsque vous activez l'option Retarder la libération, CodeGuard marque chaque ressource une fois qu'elle a été libérée, ce qui empêche les bibliothèques d'exécution et Windows de tenter de réutiliser la ressource. Certaines ressources, telles que les allocations de mémoire sur la pile, ne peuvent pas être mises en file d'attente pour une libération retardée.
Longueur de la file d'attente	Spécifie le nombre d'objets qui peuvent être mis en file d’attente pour une libération retardée. Vous pouvez définir une valeur maximale de 65 535 objets.
Taille de bloc mémoire maximale	Spécifie la taille maximale de bloc mémoire que CodeGuard peut stocker dans la file d'attente. Vous pouvez définir une valeur maximale de 65 535 octets.

Options de fonctions

Utilisez la page Options de fonctions pour spécifier comment CodeGuard couvre les divers types de fonctions.

Elément	Description
Fonctions	Liste les fonctions que CodeGuard peut suivre.
Désactiver le suivi de fonctions	Désactive le suivi des fonctions sélectionnées.
Erreurs d'accès mémoire	Signale une erreur d'exécution si une fonction utilise un pointeur pour référencer une zone mémoire invalide.
Consigner chaque appel	Signale chaque appel aux fonctions sélectionnées.
Avertissements	Signale les cas où votre application peut accéder à la mémoire au-delà de la taille maximale d'un tampon. Les avertissements sont signalés uniquement pour les fonctions suivantes de la bibliothèque d'exécution : strncmp, strnicmp, strncmpi, _fstrncmp, _fstrnicmp, memcmp, memicmp, _fmemcmp, _fmemicmp, fnmerge, fnsplit, getcurdir.
Erreurs résultats de fonction	Signale si les fonctions sélectionnées renvoient une valeur indiquant un échec.
Paramètres handle / ressource incorrects	Si l'un quelconque des paramètres des fonctions sélectionnées est un handle ou un identificateur de ressource, cette option vérifie qu'il a été correctement alloué et qu'il est actuellement valide.
Définir les options de fonctions par défaut	Affiche la boîte de dialogue Définir les options de fonctions par défaut, que vous pouvez utiliser pour voir et définir les options de fonctions par défaut.
Revenir aux options de fonctions par défaut	Applique les options de fonctions par défaut aux fonctions sélectionnées.

Modules ignorés

Utilisez la page Modules ignorés pour spécifier les modules que CodeGuard doit ignorer lors de la signalisation des erreurs.

Voir aussi

• Présentation de CodeGuard
• Utilisation de CodeGuard