Metodo IMFMetadata::GetAllLanguages (mfidl.h)

Ottiene un elenco delle lingue in cui sono disponibili i metadati.

Sintassi

HRESULT GetAllLanguages(
  [out] PROPVARIANT *ppvLanguages
);

Parametri

[out] ppvLanguages

Puntatore a un PROPVARIANT che riceve l'elenco di lingue. L'elenco viene restituito come matrice di stringhe di caratteri wide con terminazione null. Ogni stringa nella matrice è un tag del linguaggio conforme a RFC 1766.

Il tipo PROPVARIANT restituito è VT_VECTOR | VT_LPWSTR. L'elenco potrebbe essere vuoto, se non sono presenti tag di lingua. Il chiamante deve liberare propVARIANT chiamando PropVariantClear.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per altre informazioni sui tag di lingua, vedere RFC 1766, "Tag per l'identificazione delle lingue".

Per impostare la lingua corrente, chiamare FMMetadata::SetLanguage.

Esempio

Nell'esempio seguente viene illustrato come ottenere l'elenco dei tag di lingua ed enumerare l'elenco.

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

Requisiti

Vedi anche

FMMetadata

Metadati multimediali