IAgentCharacterEx::GetAnimationNames

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

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

문자의 애니메이션 이름을 검색합니다.

• 작업이 성공했음을 나타내는 S_OK 반환합니다.

Iunknown

캐릭터의 애니메이션 컬렉션에 대한 IUnknown 인터페이스의 주소입니다.

이 함수를 사용하면 문자에 대한 애니메이션의 이름을 열거할 수 있습니다. 컬렉션의 항목에는 속성이 없으므로 개별 항목에 직접 액세스할 수 없습니다. 컬렉션에 액세스하려면 iEnumVARIANT 인터페이스에 대해 punkEnum을 쿼리합니다.

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

참고

ACF 문자의 경우 컬렉션은 문자에 대해 정의된 모든 애니메이션을 반환하고 Get 메서드를 사용하여 검색된 애니메이션에 추가합니다.