IDebugFailureAnalysis2::SetUlong-Methode (extsfns.h)

Die SetUlong-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 ULONG-Wert 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 ULONG-Wert fest.

Syntax

PFA_ENTRY SetUlong(
       FA_TAG Tag,
  [in] ULONG  Value
);

Parameter

Tag

Ein -Wert in der FA_TAG-Enumeration .

[in] Value

Der ULONG-Wert , der 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, überprüft sie, ob der diesem Tag zugeordnete Datentyp DEBUG_FA_ENTRY_ULONG ist. Wenn der dem Tag zugeordnete Datentyp nicht DEBUG_FA_ENTRY_ULONG 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_ULONG zu.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile extsfns.h

Weitere Informationen

AddUlong

IDebugFailureAnalysis2

Schreiben eines Analyseerweiterungs-Plug-Ins zum Erweitern von !analyze

_EFN_Analyze