向前移动迭代器并提取下一个键的名称,并根据需要提取其值(或对其的引用)和关联的元数据。
请注意,根据获取此枚举器的方式,值字段中返回的对象可以是与键(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 |