IKeyEnumerator::GetNext 方法(dbgmodel.h)

向前移动迭代器并提取下一个键的名称,并根据需要提取其值(或对其的引用)和关联的元数据。

请注意,根据获取此枚举器的方式,值字段中返回的对象可以是与键(EnumerateKeys)关联的值、键引用的任何属性的解析值(EnumerateKeyValues)或对键(EnumerateKeyReferences)的引用。

如果解决键值时出错(例如,对于 EnumerateKeyValues),该方法可能会返回错误 AND 用错误对象填充值。 当枚举器命中序列的末尾时,将返回E_BOUNDS。

语法

HRESULT GetNext(
  BSTR                            *key,
  _COM_Errorptr_opt_ IModelObject **value,
  IKeyStore                       **metadata
);

参数

key

此处返回要枚举的密钥的名称。 调用方负责使用 SysFreeString 方法释放此字符串。

value

此处返回要枚举的键的值。 根据枚举器获取方式,此值可以是与键(EnumerateKeys)关联的值、键引用的任何属性的解析值(EnumerateKeyValues)或对键(EnumerateKeyReferences)的引用。

metadata

在此参数中,可以选择返回与密钥关联的任何元数据。

返回值

此方法返回指示成功或失败的 HRESULT。

要求

要求 价值
标头 dbgmodel.h

另请参阅

IKeyEnumerator 接口