Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This 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] Pointer to the buffer where the caller receives the RFC1766-conforming name string.

Return Value

The following table shows the possible return values for this method.

Value Description

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.

Requirements

Header mlang.h, mlang.idl
Library mlang.dll
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later