IAgentCharacterEx::GetAnimationNames

[Microsoft Agent ist ab Version Windows 7 veraltet und in nachfolgenden Versionen von Windows.]

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

Ruft die Animationsnamen für ein Zeichen ab.

  • Gibt S _ OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

Iunknown

Die Adresse der IUnknown-Schnittstelle für die Animationssammlung des Zeichens.

Mit dieser Funktion können Sie die Namen der Animationen für ein Zeichen aufzählen. Elemente in der Auflistung haben keine Eigenschaften, sodass nicht direkt auf einzelne Elemente zugegriffen werden kann. Fragen Sie für den Zugriff auf die Auflistung die Abfrage von "queryenEnum" für die IEnumVARIANT-Schnittstelle ab:

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();

Hinweis

Bei ACF-Zeichen gibt die Auflistung alle Animationen zurück, die für das Zeichen definiert wurden, und fügt den Animationen hinzu, die mit der Get-Methode abgerufen wurden.