IDebugFailureAnalysis2::SetExtensionCommand-Methode (extsfns.h)

Artikel
02/06/2025

Die SetExtensionCommand--Methode durchsucht ein DebugFailureAnalysis -Objekt für den ersten FA-Eintrag mit einem angegebenen Tag. Wenn ein FA-Eintrag mit dem angegebenen Tag gefunden wird, wird der Datenblock des FA-Eintrags auf eine angegebene Erweiterungsbefehlszeichenfolge festgelegt (überschrieben). Wenn diese Methode keinen FA-Eintrag mit dem angegebenen Tag findet, erstellt sie einen neuen FA-Eintrag mit diesem Tag und legt den Datenblock des neuen FA-Eintrags auf die angegebene Erweiterungsbefehlszeichenfolge fest.

Syntax

PFA_ENTRY SetExtensionCommand(
  FA_TAG Tag,
  PCSTR  Extension
);

Parameter

Tag

Ein Wert in der FA_TAG-Aufzählung.

Extension

Ein Zeiger auf eine mit Null beendete Zeichenfolge, bei der es sich um den Erweiterungsbefehl handelt. Ein Beispiel für einen Erweiterungsbefehl ist "!analyze -v".

Rückgabewert

Wenn diese Methode erfolgreich ist, wird ein Zeiger auf die neue oder vorhandene FA_ENTRY Struktur zurückgegeben. Andernfalls wird NULL-zurückgegeben.

Bemerkungen

Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet, wird überprüft, ob der diesem Tag zugeordnete Datentyp DEBUG_FA_ENTRY_EXTENSION_CMD oder DEBUG_FA_ENTRY_ANSI_STRINGist. Wenn der dem Tag zugeordnete Datentyp keinen dieser beiden Werte aufweist, gibt diese Methode NULL- zurück und überschreibt den Datenblock des Eintrags nicht.

Wenn diese Methode keinen FA-Eintrag mit dem angegebenen Tag findet, erstellt sie einen neuen FA-Eintrag mit diesem Tag und ordnet das Tag dem Datentyp DEBUG_FA_ENTRY_EXTENSION_CMDzu.