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 |