IMultiLanguage::GetRfc1766FromLcid Method

Retrieves the RFC1766-conforming name that corresponds to the given locale identifier (LCID).

Syntax

HRESULT GetRfc1766FromLcid(
    LCID Locale,
    BSTR *pbstrRfc1766
);

Parameters

Locale
[in] LCID for which the caller wants to retrieve the RFC1766-conforming name.
pbstrRfc1766
[out] Address of the buffer where the caller receives the RFC1766-conforming name string.

Return Value

Returns one of the following values:

S_OK Success.

E_FAIL The method could not get the information from the database or the system.

E_INVALIDARG One or more of the arguments are invalid.

Remarks

A client uses this method to retrieve a human-readable name for the specified LCID. For example, this method could be used to build an acceptable-language header for Internet applications. The method retrieves the information from the MIME database character set extension if it exists; otherwise, it uses National Language Support (NLS) functions to build two-letter names on the fly.

S_OK	Success.
E_FAIL	The method could not get the information from the database or the system.
E_INVALIDARG	One or more of the arguments are invalid.