IAgentCharacterEx：：GetAnimationNames

[从 Windows 7 开始，Microsoft代理已弃用，在后续版本的 Windows 中可能不可用。

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

检索字符的动画名称。

• 返回 S_OK 以指示作成功。

IUnknown

字符动画集合的 IUnknown 接口的地址。

使用此函数可以枚举字符的动画名称。 集合中的项没有属性，因此无法直接访问各个项。 若要访问集合，请查询 punkEnum 以获取 IEnumVARIANT 接口：

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 方法检索的动画。