IMFMetadata::GetAllLanguages-Methode (mfidl.h)

  • Artikel

Ruft eine Liste der Sprachen ab, in denen Metadaten verfügbar sind.

Syntax

HRESULT GetAllLanguages(
  [out] PROPVARIANT *ppvLanguages
);

Parameter

[out] ppvLanguages

Ein Zeiger auf einen PROPVARIANT , der die Liste der Sprachen empfängt. Die Liste wird als Array von mit NULL endenden Breitzeichenzeichenfolgen zurückgegeben. Jede Zeichenfolge im Array ist ein RFC 1766-kompatibles Sprachtag.

Der zurückgegebene PROPVARIANT-Typ ist VT_VECTOR | VT_LPWSTR. Die Liste ist möglicherweise leer, wenn keine Sprachtags vorhanden sind. Der Aufrufer muss PROPVARIANT durch Aufrufen von PropVariantClear freigeben.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Weitere Informationen zu Sprachtags finden Sie unter RFC 1766, "Tags für die Identifizierung von Sprachen".

Um die aktuelle Sprache festzulegen, rufen Sie IMFMetadata::SetLanguage auf.

Beispiele

Das folgende Beispiel zeigt, wie Sie die Liste der Sprachtags abrufen und die Liste auflisten.

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;
}

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mfuuid.lib

Weitere Informationen

IMFMetadata

Medienmetadaten