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 |