IAgentCharacterEx::GetAnimationNames

[Microsoft Agent est déconseillé à partir de Windows 7 et peut ne pas être disponible dans les versions ultérieures de Windows.]

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

Récupère les noms d’animation d’un caractère.

• Retourne S_OK pour indiquer que l’opération a réussi.

Iunknown

Adresse de l’interface IUnknown pour la collection d’animations du caractère.

Cette fonction vous permet d’énumérer les noms des animations d’un caractère. Les éléments de la collection n’ayant aucune propriété, les éléments individuels ne sont pas accessibles directement. Pour accéder à la collection, interrogez punkEnum pour l’interface 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();

Notes

Pour les caractères ACF, la collection retourne toutes les animations qui ont été définies pour le caractère, en ajoutant à celles qui ont été récupérées avec la méthode Get .