Compartir a través de

IAgentCharacterEx::GetAnimationNames

  • Artículo

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de Windows.

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

Recupera los nombres de animación de un carácter.

  • Devuelve S_OK para indicar que la operación se realizó correctamente.

Iunknown

Dirección de la interfaz IUnknown de la colección de animaciones del carácter.

Esta función permite enumerar los nombres de las animaciones de un carácter. Los elementos de la colección no tienen propiedades, por lo que no se puede acceder directamente a elementos individuales. Para acceder a la colección, consulte punkEnum para la interfaz 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();

Nota:

En el caso de los caracteres ACF, la colección devuelve todas las animaciones definidas para el carácter, agregando a las que se han recuperado con el método Get .