IMultiLanguage::GetRfc1766FromLcid method

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

Syntax

HRESULT GetRfc1766FromLcid(
  [in]  LCID Locale,
  [out] BSTR *pbstrRfc1766
);

Parameters

  • Locale [in]
    The LCID for which the caller wants to get the RFC1766-conforming name.

  • pbstrRfc1766 [out]
    The address of the buffer where the caller receives the RFC1766-conforming name string.

Return value

Returns one of the following values.

Return code Description
S_OK

Success.

E_FAIL

The method cannot get the information from the database or the system.

E_INVALIDARG

One or more of the arguments is invalid.

 

Remarks

A client uses this method to get a human-readable name for the specified LCID. For example, this method can be used to build an acceptable-language header for Internet applications. The method gets 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.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Mlang.h

IDL

Mlang.idl

DLL

Mlang.dll

See also

IMultiLanguage

Reference

GetLcidFromRfc1766

GetRfc1766Info

RFC1766INFO