IAgentCharacterEx::GetAnimationNames

[O Microsoft Agent é preterido a partir do Windows 7 e pode estar indisponível nas versões subsequentes do Windows.]

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

Recupera os nomes de animação de um caractere.

  • Retorna S_OK para indicar que a operação foi bem-sucedida.

Iunknown

O endereço da interface IUnknown para a coleção de animação do caractere.

Essa função permite que você enumere os nomes das animações para um caractere. Os itens na coleção não têm propriedades, portanto, os itens individuais não podem ser acessados diretamente. Para acessar a coleção, consulte punkEnum para a 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();

Observação

Para caracteres ACF, a coleção retorna todas as animações que foram definidas para o caractere, adicionando às que foram recuperadas com o método Get .