IMFMetadata::GetLanguage method (mfidl.h)

Gets the current language setting.

Syntax

HRESULT GetLanguage(
  [out] LPWSTR *ppwszRFC1766
);

Parameters

[out] ppwszRFC1766

Receives a pointer to a null-terminated string containing an RFC 1766-compliant language tag. The caller must release the string by calling CoTaskMemFree.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_NOTIMPL
The metadata provider does not support multiple languages.
MF_E_INVALIDREQUEST
No language was set.

Remarks

For more information about language tags, see RFC 1766, "Tags for the Identification of Languages."

The IMFMetadata::SetLanguage and IMFMetadata::GetProperty methods set and get metadata for the current language setting.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See also

IMFMetadata

Media Metadata