IDebugFailureAnalysis2::AddString-Methode (extsfns.h)

Artikel
02/26/2024

Die AddString-Methode fügt einem DebugFailureAnalysis-Objekt einen neuen FA-Eintrag 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-Enumeration . Der diesem Tag zugeordnete Datentyp muss DEBUG_FA_ENTRY_ANSI_STRING sein.

[in] Str

Ein Zeiger auf eine NULL-endende ANSI-Zeichenfolge, die in den Datenblock des neuen FA-Eintrags geschrieben werden soll.

Rückgabewert

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

Hinweise

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

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

Um einen Zeiger auf eine IDebugFAEntryTags-Schnittstelle abzurufen, rufen Sie die GetDebugFATagControl-Methode der IDebugFailureAnalysis2-Schnittstelle auf.