IDebugFailureAnalysis2::AddUlong64 method (extsfns.h)

Article
02/22/2024

The AddUlong64 method adds a new FA entry to a DebugFailureAnalysis object and sets the data block of the FA entry to a specified 64-bit value.

Syntax

PFA_ENTRY AddUlong64(
       FA_TAG  Tag,
  [in] ULONG64 Value
);

Parameters

Tag

A value in the FA_TAG enumeration. The data type associated with this tag must be DEBUG_FA_ENTRY_ULONG64 or DEBUG_FA_ENTRY_POINTER or DEBUG_FA_ENTRY_INSTRUCTION_OFFSET.

[in] Value

The ULONG64 value to be written to the data block of the new FA entry.

Return value

If this method succeeds, it returns a returns a pointer to the new FA_ENTRY structure. If this method fails, it returns NULL.

Remarks

Each tag is associated with one of the data types in the FA_ENTRY_TYPE enumeration. To determine the data type associated with a tag, call the GetType method of the IDebugFAEntryTags interface.

To get a pointer to an IDebugFAEntryTags interface, call the GetDebugFATagControl method of the IDebugFailureAnalysis2 interface.

Requirements

Requirement	Value
Target Platform	Desktop
Header	extsfns.h