MÉTHODE IMFMetadata::GetAllLanguages (mfidl.h)

Obtient la liste des langues dans lesquelles les métadonnées sont disponibles.

Syntaxe

HRESULT GetAllLanguages(
  [out] PROPVARIANT *ppvLanguages
);

Paramètres

[out] ppvLanguages

Pointeur vers un PROPVARIANT qui reçoit la liste des langues. La liste est retournée sous la forme d’un tableau de chaînes de caractères larges terminées par null. Chaque chaîne du tableau est une balise de langage conforme À la norme RFC 1766.

Le type PROPVARIANT retourné est VT_VECTOR | VT_LPWSTR. La liste peut être vide si aucune balise de langue n’est présente. L’appelant doit libérer propVARIANT en appelant PropVariantClear.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

Pour plus d’informations sur les balises de langue, consultez RFC 1766, « Balises pour l’identification des langues ».

Pour définir la langue actuelle, appelez IMFMetadata::SetLanguage.

Exemples

L’exemple suivant montre comment obtenir la liste des balises de langue et énumérer la liste.

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

Spécifications

Client minimal pris en charge	Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mfuuid.lib

Voir aussi

IMFMetadata

Métadonnées de média