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,则此参数不接收任何信息。 应将 Name 和 NameSize 都设置为非 NULL 值,或者将它们都设置为 NULL。
[out] Description
指向缓冲区的指针,该缓冲区接收以 null 结尾的字符串,该字符串是标记的说明。 如果 DescSize 小于标记说明的长度,则此方法仅将 DescSize 字节(包括 NULL 终止符)复制到此缓冲区。
[in, out] DescSize
输入时,此参数指定 Description 指向的缓冲区的大小(以字节为单位)。 输出时,此参数接收标记说明的大小(以字节为单位)。 如果标记没有说明,此参数将接收值 0。
注意 如果 Description 为 NULL,则此参数不接收任何信息。 应同时将 Description 和 DescSize 设置为非 NULL 值,或者将它们都设置为 NULL。
[out] Flags
保留。 将此参数设置为 NULL。
返回值
此方法返回的 HRESULT 值在 winerror.h 和 strsafe.h 中定义。 此方法返回的值包括但不限于以下内容:
返回代码 | 说明 |
---|---|
|
此方法成功检索了请求的名称或说明 (或两者) ,并且不需要截断请求的字符串或字符串。 |
|
此方法检索请求的名称或说明 (或两者) ,但名称或说明被截断。 |
|
调用方传递了至少一个无效参数。 |
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | extsfns.h |