IAgentCharacterEx：：GetAnimationNames

[從 Windows 7 開始，Microsoft Agent 已被取代，而且在後續版本的 Windows 中可能無法使用。]

HRESULT GetAnimationNames(
   IUnknown ** punkEnum // address of IUnknown interface
);

擷取字元的動畫名稱。

• 傳回 S_OK ，表示作業成功。

IUnknown

字元動畫集合之 IUnknown 介面的位址。

此函式可讓您列舉字元的動畫名稱。 集合中的專案沒有屬性，因此無法直接存取個別專案。 若要存取集合，請查詢 IEnumVARIANT 介面的 punkEnum：

IEnumVARIANT pEnum;
VARIANT vAnimName;
DWORD dwRetrieved;

hRes = punkEnum->QueryInterface(IID_IEnumVARIANT, (LPVOID *)&pEnum);

if (SUCCEEDED(hRes)) {

    while (TRUE) {

         hRes = pEnum->Next(1, &vAnimName, &dwRetrieved);

         if (hRes != NOERROR)
            break;

         // vAnimName.bstrVal is the animation name

         VariantClear(&vAnimName);
    } 

    pEnum->Release();
}

punkEnum->Release();

注意

針對 ACF 字元，集合會傳回為字元定義的所有動畫，並將 新增至已使用 Get 方法擷取的動畫。