IDebugFailureAnalysis2::SetString-Methode (extsfns.h)

Artikel
02/06/2025

Die SetString--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 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-Aufzählung.

[in] Str

Ein Zeiger auf eine mit Null beendete ANSI-Zeichenfolge, die in den Datenblock des neuen oder vorhandenen FA-Eintragsgeschrieben 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.

Bemerkungen

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_CMDist. 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_STRINGzu.