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。

注意 如果 Name 为 NULL,则此参数不接收任何信息。 应将 NameNameSize 都设置为非 NULL 值,或者将它们都设置为 NULL
 

[out] Description

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

[in, out] DescSize

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

注意 如果 Description 为 NULL,则此参数不接收任何信息。 应同时将 DescriptionDescSize 设置为非 NULL 值,或者将它们都设置为 NULL
 

[out] Flags

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

返回值

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

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

要求

要求
目标平台 桌面
标头 extsfns.h

另请参阅

IDebugFAEntryTags

IDebugFailureAnalysis2

SetProperties

编写分析扩展插件以扩展 !analyze

_EFN_Analyze