IDebugFAEntryTags::SetProperties-Methode (extsfns.h)

Artikel
02/06/2025

Die SetProperties- methode legt den Namen oder die Beschreibung (oder beide) eines Tags in einem DebugFailureAnalysisTags-Objekt fest.

Syntax

HRESULT SetProperties(
  [in] FA_TAG Tag,
  [in] PCSTR  Name,
  [in] PCSTR  Description,
  [in] ULONG  Flags
);

Parameter

[in] Tag

Ein Wert in der FA_TAG-Aufzählung. Diese Methode legt den Namen oder die Beschreibung (oder beide) dieses Tags fest.

[in] Name

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den festzulegenden Namen angibt. Wenn das Tag bereits einen Namen hat, überschreibt diese Methode den alten Namen. Wenn dieser Parameter NULL-ist, wird der Name des Tags nicht geändert.

[in] Description

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die die festzulegende Beschreibung angibt. Wenn das Tag bereits über eine Beschreibung verfügt, überschreibt diese Methode die alte Beschreibung. Wenn dieser Parameter NULL-ist, wird die Beschreibung des Tags nicht geändert.

[in] Flags

Reserviert. Legen Sie diesen Parameter auf NULL-fest.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein Fehlercode zurückgegeben. Fehlercodes werden in winerror.h und strsafe.h definiert.