IAgentCharacterEx::GetAnimationNames

[Microsoft Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

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 einzelne Elemente nicht direkt zugegriffen werden können. Um auf die Sammlung zuzugreifen, abfrage punkEnum für die IEnumVARIANT-Schnittstelle:

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ügen Sie den mit der Get-Methode abgerufenen Hinzufügungen hinzu.