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 |