IDebugFailureAnalysis2::SetString-Methode (extsfns.h)
Die SetString-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 einen angegebenen Zeichenfolgenwert 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 den angegebenen Zeichenfolgenwert fest.
Syntax
PFA_ENTRY SetString(
FA_TAG Tag,
[in] PCSTR Str
);
Parameter
Tag
Ein Wert in der FA_TAG-Enumeration .
[in] Str
Ein Zeiger auf eine NULL-beendete ANSI-Zeichenfolge, die in den Datenblock des neuen oder vorhandenen FA-Eintrags geschrieben werden soll.
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, wird überprüft, ob der diesem Tag zugeordnete Datentyp DEBUG_FA_ENTRY_ANSI_STRING oder DEBUG_FA_ENTRY_EXTENSION_CMD ist. Wenn der dem Tag zugeordnete Datentyp nicht einer dieser beiden Typen ist, 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_ANSI_STRING zu.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | extsfns.h |
Weitere Informationen
Schreiben eines Analyseerweiterungs-Plug-Ins zum Erweitern von !analyze