SetupDesignGuide.pdf - Firmware Encoding Index

Setup Design Guide
DRAFT
7.1.8 EFI_HII_PROTOCOL.GetSecondaryLanguages()
Summary
This function allows a program to determine which secondary languages are supported on a given
handle for a given primary language.
Prototype
EFI_STATUS
(EFIAPI *EFI_HII_GET_SEC_LANGUAGES) (
IN EFI_HII_PROTOCOL
*This,
IN EFI_HII_HANDLE
Handle,
IN CHAR16
*PrimaryLanguage,
OUT EFI_STRING
*LanguageString
);
Parameters
This
Handle
PrimaryLanguage
LanguageString
A pointer to the EFI_HII_PROTOCOL instance.
Handle on which the strings reside.
Pointer to a NULL-terminated string containing a single ISO-639-2
language identifier, indicating the primary language.
A string allocated by GetSecondaryLanguages containing a
list of all secondary languages registered on the handle. The routine
will not return the 3-spaces language identifier used in other
functions to indicate non-language-specific strings, nor will it return
the primary language. This function succeeds but returns a NULL
LanguageString if there are no secondary languages associated
with the input Handle and PrimaryLanguage pair.
Description
Each string package has associated with it a single primary language and zero or more secondary
languages. This routine returns the secondary languages associated with a string package. The string
package is identified by the package list handle and the (currently three character ISO-639-2 primary
language identifier.
Status Codes Returned
EFI_SUCCESS
EFI_INVALID_PARAMETER
Correctly returned the LanguageString.
Unknown handle.
59