IAgentCharacterEx::GetAnimationNames

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di Windows.]

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

Recupera i nomi di animazione per un carattere.

• Restituisce S_OK per indicare che l'operazione ha avuto esito positivo.

Iunknown

Indirizzo dell'interfaccia IUnknown per la raccolta di animazioni del carattere.

Questa funzione consente di enumerare i nomi delle animazioni per un carattere. Gli elementi della raccolta non hanno proprietà, pertanto non è possibile accedere direttamente ai singoli elementi. Per accedere alla raccolta, eseguire query punkEnum per l'interfaccia 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

Per i caratteri ACF, la raccolta restituisce tutte le animazioni definite per il carattere, aggiungendo a quelle recuperate con il metodo Get .