IKeyEnumerator::GetNext 方法 (dbgmodel.h)

向前移动迭代器并提取下一个键的名称,还可以选择将其值 (或对其的引用) 和关联的元数据。

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

如果在解析 EnumerateKeyValues 的键 (值(例如) )时出错,则该方法可能会返回错误 ,并 用错误对象填充值。 当枚举器到达序列的末尾时,将返回E_BOUNDS。

语法

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

参数

key

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

value

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

metadata

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

返回值

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

要求

要求
Header dbgmodel.h

另请参阅

IKeyEnumerator 接口