IMFMetadata::GetAllLanguages 메서드(mfidl.h)

메타데이터를 사용할 수 있는 언어 목록을 가져옵니다.

구문

HRESULT GetAllLanguages(
  [out] PROPVARIANT *ppvLanguages
);

매개 변수

[out] ppvLanguages

언어 목록을 수신하는 PROPVARIANT 에 대한 포인터입니다. 목록은 null로 끝나는 와이드 문자열의 배열로 반환됩니다. 배열의 각 문자열은 RFC 1766 규격 언어 태그입니다.

반환된 PROPVARIANT 형식이 VT_VECTOR | VT_LPWSTR. 언어 태그가 없는 경우 목록이 비어 있을 수 있습니다. 호출자는 PropVariantClear를 호출하여 PROPVARIANT를 해제해야 합니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

언어 태그에 대한 자세한 내용은 RFC 1766, "언어 식별 태그"를 참조하세요.

현재 언어를 설정하려면 IMFMetadata::SetLanguage를 호출합니다.

예제

다음 예제에서는 언어 태그 목록을 가져와서 목록을 열거하는 방법을 보여 줍니다.

HRESULT DisplayLanguageList(IMFMetadata *pMetadata)
{
    PROPVARIANT varLangs;

    HRESULT hr = pMetadata->GetAllLanguages(&varLangs);
    if (SUCCEEDED(hr))
    {
        if (varLangs.vt == (VT_VECTOR | VT_LPWSTR))
        {
            for (ULONG i = 0; i < varLangs.calpwstr.cElems; i++)
            {
                wprintf(L"%s\n", varLangs.calpwstr.pElems[i]);
            }
        }
        else
        {
            hr = E_UNEXPECTED;
        }
        PropVariantClear(&varLangs);
    }
    return hr;
}

요구 사항

지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	mfidl.h
라이브러리	Mfuuid.lib

참고 항목

IMFMetadata

미디어 메타데이터