共用方式為


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 介面