IDebugFAEntryTags：：GetProperties 方法（extsfns.h）

GetProperties 方法获取 DebugFailureAnalysisTags 对象中标记的名称或说明（或两者）。

语法

HRESULT GetProperties(
            FA_TAG Tag,
  [out]     PSTR   Name,
  [in, out] PULONG NameSize,
  [out]     PSTR   Description,
  [in, out] PULONG DescSize,
  [out]     PULONG Flags
);

参数

Tag

FA_TAG 枚举中的值。此方法获取此标记的名称或说明（或两者）。

[out] Name

指向接收以 null 结尾的字符串的缓冲区的指针，该字符串是标记的名称。如果 NameSize 小于标记名称的长度，此方法仅将 NameSize 字节（包括 NULL 终止符）复制到此缓冲区。

[in, out] NameSize

在输入时，此参数指定 Name指向的缓冲区的大小（以字节为单位）。输出时，此参数接收标记名称的大小（以字节为单位）。如果标记没有名称，此参数将接收值 0。

注意如果名称为 NULL，则此参数不接收任何信息。应同时将 Name 和 NameSize 设置为非 NULL 值，或将它们都设置为 NULL。

[out] Description

指向接收以 null 结尾的字符串的缓冲区的指针，该字符串是标记的说明。如果 DescSize 小于标记说明的长度，此方法仅 DescSize 字节（包括 null 终止符）复制到此缓冲区。

[in, out] DescSize

在输入时，此参数指定说明指向的缓冲区的大小（以字节为单位）。在输出中，此参数接收标记说明的大小（以字节为单位）。如果标记没有说明，此参数将接收值 0。

注释如果说明为 NULL，则此参数不接收任何信息。应同时将说明和 DescSize 设置为非 NULL 值，或将它们都设置为 NULL。

[out] Flags

保留。将此参数设置为 NULL。

返回值

此方法返回 HRESULT 值在 winerror.h 和 strsafe.h 中定义。此方法返回的值包括但不限于以下内容：

返回代码	描述
S_OK	此方法已成功检索请求的名称或说明（或两者），并且不需要截断所请求的字符串或字符串。
STRSAFE_E_INSUFFICIENT_BUFFER	此方法检索了请求的名称或说明（或两者），但名称或说明被截断。
STRSAFE_E_INVALID_PARAMETER	调用方至少传递了一个无效参数。