IAgentCharacterEx ::GetAnimationNames

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible 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’ont aucune propriété, de sorte que 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();

Note

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.