CodeGuard-Konfiguration

Nach oben zu Menü Tools

Tools > CodeGuard-Konfiguration

Mit dem Dialogfeld CodeGuard-Konfiguration legen Sie das Verhalten des CodeGuard-Laufzeit-Debuggers fest. Sie können dieses Dialogfeld durch Ausführen des Hilfsprogramms cgconfig.exe aufrufen, das im Produktinstallationsverzeichnis verfügbar ist. Wenn Sie Einstellungen im Dialogfeld CodeGuard-Konfiguration ändern, wird eine .cgi-Konfigurationsdatei mit dem Namen des Projekts erstellt und im Projektverzeichnis gespeichert.

Hinweis: CodeGuard steht nur für C++-Projekte zur Verfügung.

Element	Beschreibung
Aktivieren (CodeGuard)	Aktiviert oder deaktiviert CodeGuard.
Stack-Füllfrequenz	Gibt an, wie häufig CodeGuard den nicht initialisierten Teil des Laufzeit-Stack mit einem eindeutigen Byte-Muster füllt. Werte: -1 = Nie 0 = Nach jedem Aufruf einer Laufzeitfunktion, die von CodeGuard abgedeckt wird. n [0...15] = Nach allen 2^n Aufrufen einer Laufzeitfunktion, die von CodeGuard abgedeckt wird. Zum Beispiel, wenn n 1 ist, dann wird der Stack jedes zweite Mal gefüllt, wenn eine Laufzeitfunktion aufgerufen wird.
Statistik	Gibt eine Funktions- und Ressourcenverwendungsstatistik aus.
Ressourcen-Lecks	Gibt Ressourcen-Lecks an, die nach dem Ende der Anwendung entdeckt wurden.
An OutputDebugString senden	Verwendet die Funktion OutputDebugString, um CodeGuard-Meldungen an den externen Debugger zu senden.
An Protokoll anhängen	Hängt das Fehlerprotokoll an das vorhandene Protokoll an. Wenn diese Option deaktiviert ist, überschreibt CodeGuard das vorhandene Fehlerprotokoll.
Wiederkehrende Fehler	Meldet Fehler, die wiederholt in einer Funktion auftreten.
Anzahl von Fehlermeldungen begrenzen	Beschränkt die Anzahl der berichteten Fehler. Sie können einen Maximalwert von 65535 eingeben.
Aktivieren (Fehlermeldung)	Aktiviert das Fehlermeldungsfenster. Wenn Sie eine CodeGuard-aktivierte Anwendung außerhalb von RAD Studio ausführen, wird das Fehlermeldungsfenster angezeigt, wenn Laufzeitfehler auftreten.
Titel	Legt den Text fest, der in der Titelleiste des Fensters angezeigt wird.
Meldung	Legt die angezeigte Fehlermeldung fest.
Debug-Info lesen	Ermöglicht, dass CodeGuard anhand der Debug-Informationen in Ihrem Projekt auf eine Quelltextzeile verweisen kann, wenn ein Laufzeitfehler aufgetreten ist.
Quellpfad	Wenn sich der Quellcode an einem anderen Speicherort befindet als die ausführbare Datei, dann geben Sie hier den Pfad (oder die Pfade, getrennt durch Semikolon) an. CodeGuard überprüft zunächst den eigenen Debug-Quellpfad und dann den IDE-Debug-Quellpfad (sofern CodeGuard in der IDE ausgeführt wird).

Ressourcenoptionen

Verwenden Sie die Seite Ressourcenoptionen, um anzugeben, wie CodeGuard die verschiedenen Ressourcentypen behandeln soll.

Element	Beschreibung
Ressourcen	Listet die Ressourcentypen auf, die CodeGuard behandeln kann: Speicherblock – Speicher, der von den Funktionen malloc und free verwaltet wird. Objekt – Speicher, der von den Operatoren new und delete verwaltet wird. Objektarray – Speicher, der von den Operatoren new[] und delete[] verwaltet wird. Datei-Handle – Datei, die von den Funktionen open und close verwaltet wird. Datei-Stream – Datei, die von den Funktionen fopen und fclose verwaltet wird. Pipe-Stream – Befehls-Prozessor-Pipe, die von den Funktionen _popen und _pclose verwaltet wird. Verzeichnis-Stream – Verzeichnis, das von den Funktionen opendir und closedir verwaltet wird.
Verfolgung aktivieren	Aktiviert die Verfolgung der ausgewählten Ressource. Eine deaktivierte Verfolgung führt zu geringerer Speicherbeanspruchung und schnellerer Ausführung.
Ressourcen-Lecks verfolgen	Gibt Ressourcen-Zuweisungen an, die keine entsprechende Freigabe haben. Zum Beispiel kann ein Leck durch fehlende Freigabe eines Datei-Handles vor dem Programmabbruch entstehen.
Meldung bei ungültigen Handle- oder Ressourcen-Parametern	Gibt eine nicht korrekte Verwendung der Ressourcen in Funktionsargumenten an.
Freigabe verzögern	Verfolgt die ausgewählte Ressource nach der Freigabe. Ist die Option Freigabe verzögern aktiv, kennzeichnet CodeGuard jede Ressource einmal, sobald sie freigegeben ist. Gleichzeitig werden Windows und die Laufzeit-Bibliotheken daran gehindert, die Ressource wiederzuverwenden. Einige Ressourcen, z.B. Stack-Speicherzuweisungen, können nicht in die Warteschlange für die verzögerte Freigabe gestellt werden.
Länge der Verzögerungswarteschlange	Gibt die Anzahl der Objekte an, die für die verzögerte Freigabe in die Warteschlange gestellt werden können. Sie können einen Maximalwert von 65535 Objekten eingeben.
Max. Größe für Speicherblöcke	Gibt die maximale Anzahl der Speicherblöcke an, die CodeGuard in der Warteschlange speichern kann. Sie können einen Maximalwert von 65535 Byte festlegen.

Funktionsoptionen

Verwenden Sie die Seite Funktionsoptionen, um anzugeben, wie CodeGuard die verschiedenen Funktionstypen behandeln soll.

Element	Beschreibung
Funktionen	Listet die Funktionen auf, die CodeGuard verfolgen kann.
Funktionsverfolgung deaktivieren	Deaktiviert die Funktionsverfolgung für die ausgewählten Funktionen.
Speicherzugriffsfehler	Meldet einen Laufzeitfehler, wenn eine Funktion einen Zeiger auf ungültigen Speicher verwendet.
Jeden Aufruf protokollieren	Meldet jeden Aufruf der ausgewählten Funktionen.
Warnungen	Meldet Situationen, in denen die Anwendung auf einen Speicherplatz jenseits der Maximalgröße des Puffers zugreift. Warnungen werden nur für die folgenden Laufzeit-Bibliotheksfunktionen ausgegeben: strncmp, strnicmp, strncmpi, _fstrncmp, _fstrnicmp, memcmp, memicmp, _fmemcmp, _fmemicmp, fnmerge, fnsplit, getcurdir.
Fehler bei Funktionsergebnissen	Meldet, wenn die ausgewählte Funktion einen Wert zurückgibt, der einen Fehler anzeigt.
Ungültige Handle- und Ressourcenparameter	Wenn es sich bei einem der ausgewählten Funktionsparameter um einen Handle- oder Ressourcenbezeichner handelt, sollte überprüft werden, ob dieser korrekt zugewiesen und aktuell gültig ist.
Standardoptionen setzen	Zeigt das Dialogfeld Standard-Funktionsoptionen festlegen an, in dem Sie die Standard-Funktionsoptionen anzeigen und setzen können.
Standard-Funktionsoptionen	Weist den ausgewählten Funktionen die Standard-Funktionsoptionen zu.

Ignorierte Module

Auf der Seite Ignorierte Module geben Sie die Module an, die CodeGuard beim Fehlerbericht überspringen soll.

Siehe auch

• Überblick zu CodeGuard
• CodeGuard verwenden