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 方法擷取的動畫。