IDebugFAEntryTags::SetType method (extsfns.h)

Article
02/22/2024

The SetType method sets the data type that is associated with a tag in a DebugFailureAnalysisTags object.

Syntax

HRESULT SetType(
  [in] FA_TAG        Tag,
  [in] FA_ENTRY_TYPE EntryType
);

Parameters

[in] Tag

A value in the FA_TAG enumeration.

[in] EntryType

A value in the FA_ENTRY_TYPE enumeration.

Return value

If this method successfully sets the data type of Tag to EntryType, it returns S_OK. Otherwise, it returns E_INVALIDARG.

Remarks

This method checks to see whether the data type for Tag has already been set. If the data type has not already been set, this method sets the data type to EntryType.

If the data type for Tag has already been set, this method checks to see whether EntryType is compatible with the data type that has already been set. If the data types are compatible, this method sets (overwrites) the data type for Tag to EntryType. If the data types are not compatible, this method returns E_INVALIDARG and does not set the data type.

The data types DEBUG_FA_ENTRY_ULONG64, DEBUG_FA_ENTRY_INSTRUCTION_OFFSET, and DEBUG_FA_ENTRY_POINTER are compatible.

The data types DEBUG_FA_ENTRY_ANSI_STRING and DEBUG_FA_ENTRY_EXTENSION_CMD are compatible.

Requirements

Requirement	Value
Target Platform	Desktop
Header	extsfns.h