IDebugFailureAnalysis2::AddString-Methode (extsfns.h)

Artikel
02/06/2025

Die AddString--Methode fügt einen neuen FA-Eintrag zu einem DebugFailureAnalysis-Objekt hinzu und legt den Datenblock des FA-Eintrags auf eine angegebene Zeichenfolge fest.

Syntax

PFA_ENTRY AddString(
       FA_TAG Tag,
  [in] PCSTR  Str
);

Parameter

Tag

Ein Wert in der FA_TAG-Aufzählung. Der diesem Tag zugeordnete Datentyp muss DEBUG_FA_ENTRY_ANSI_STRINGsein.

[in] Str

Ein Zeiger auf eine MIT NULL beendete ANSI-Zeichenfolge, die in den Datenblock des neuen FA-Eintragsgeschrieben werden soll.

Rückgabewert

Wenn diese Methode erfolgreich verläuft, wird ein Zeiger auf die neue FA_ENTRY Struktur zurückgegeben. Wenn diese Methode fehlschlägt, wird NULL-zurückgegeben.

Bemerkungen

Diese Methode legt den DataSize Member der neuen FA_ENTRY-Struktur auf die Länge der Zeichenfolge in Byte fest, einschließlich des NULL Endator.

Jedes Tag ist einem der Datentypen in der FA_ENTRY_TYPE-Aufzählung zugeordnet. Um den einem Tag zugeordneten Datentyp zu ermitteln, rufen Sie die GetType--Methode der IDebugFAEntryTags Schnittstelle auf.

Rufen Sie zum Abrufen eines Zeigers auf eine IDebugFAEntryTags- Schnittstelle die GetDebugFATagControl-methode der IDebugFailureAnalysis2-Schnittstelle auf.