共用方式為

IModelObject：：EnumerateKeyValues 方法 (dbgmodel.h)

  • 發行項

EnumerateKeyValues 方法是客戶端將開啟的第一個方法，以便列舉物件上的所有索引鍵， (這包括父模型樹狀結構中任何位置實作的所有索引鍵) 。 請務必注意，EnumerateKeyValues 會列舉物件樹狀結構中重複名稱所定義的任何索引鍵;不過-- GetKeyValue 和 SetKeyValue 等方法只會操作具有指定名稱的索引鍵實例，如深度優先周遊所探索。

語法

HRESULT EnumerateKeyValues(
  IKeyEnumerator **enumerator
);

參數

enumerator

物件上所有索引鍵的列舉值 (及其所有父模型) 及其值和元數據都會在此自變數中傳回為 IKeyEnumerator。

傳回值

這個方法會傳回 HRESULT，指出成功或失敗。

備註

程式碼範例

ComPtr<IModelObject> spObject; /* get the object you want to enumerate */

ComPtr<IKeyEnumerator> spEnum;
if (SUCCEEDED(spObject->EnumerateKeyValues(&spEnum)))
{
    HRESULT hr = S_OK;
    while (SUCCEEDED(hr))
    {
        BSTR keyName;
        ComPtr<IModelObject> spKeyValue;
        hr = spEnum->GetNext(&keyName, &spKeyValue, nullptr);
        if (SUCCEEDED(hr))
        {
            // keyName contains the name of the key
            // spKeyValue contains the value of the key

            SysFreeString(keyName);
        }
    }

    // hr == E_BOUNDS  : We hit the end of the enumerator
    // hr == E_ABORT   : User is requesting interruption of the 
    // operation / stop immediately and flow the error
}

規格需求

需求 值
標頭 dbgmodel.h

另請參閱

IModelObject 介面