IDebugFailureAnalysis::GetString-Methode (extsfns.h)

Artikel
02/06/2025

Die GetString--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, ruft er den ANSI-Zeichenfolgenwert aus dem Datenblock des Eintrags ab.

Syntax

PFA_ENTRY GetString(
  [in]  FA_TAG Tag,
  [out] PSTR   Str,
  [in]  ULONG  MaxSize
);

Parameter

[in] Tag

Ein Wert in der FA_TAG-Aufzählung.

[out] Str

Ein Zeiger auf einen Puffer, der den Zeichenfolgenwert aus dem Datenblock des Eintrags empfängt.

[in] MaxSize

Die Größe des Puffers in Byte, auf den Strverweist.

Rückgabewert

Wenn diese Methode einen FA-Eintrag mit dem angegebenen Tag findet und es erfolgreich ist, den Datenblock abzurufen, wird ein Zeiger auf die FA_ENTRY-Struktur zurückgegeben. Andernfalls wird NULL-zurückgegeben.

Bemerkungen

Diese Methode kopiert eine mit Null beendete Zeichenfolge aus dem Datenblock des Eintrags in den Puffer, auf den Strverweist. Diese Methode kopiert höchstens MaxSize Zeichen, einschließlich des NULL-Terminators.

Jedes Tag, das bereits in einem DebugFailureAnalysis-Objekt verwendet wurde, 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.

Die entsprechende Verwendung dieser Methode ist das Abrufen des Datenblocks aus einem FA-Eintrag mit einem Datentyp von DEBUG_FA_ENTRY_ANSI_STRING.