IMFMetadata::GetAllLanguages-Methode (mfidl.h)
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 |