IDebugFailureAnalysis2::SetExtensionCommand-Methode (extsfns.h)
Die SetExtensionCommand-Methode durchsucht ein DebugFailureAnalysis-Objekt nach dem ersten FA-Eintrag , der über ein angegebenes Tag verfügt. 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-Enumeration .
Extension
Ein Zeiger auf eine 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.
Hinweise
Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet, überprüft sie, ob der diesem Tag zugeordnete Datentyp DEBUG_FA_ENTRY_EXTENSION_CMD oder DEBUG_FA_ENTRY_ANSI_STRING ist. 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_CMD zu.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | extsfns.h |
Weitere Informationen
Schreiben eines Analyseerweiterungs-Plug-Ins zum Erweitern von !analyze