SetLocaleInfo
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função define um item de informações localidade. Ele faz isso fazendo uma entrada na parte processo de tabela de localidade. Esta configuração afeta somente o usuário substituir parte das configurações de localidade; Ele não define os padrões sistema.
Syntax
BOOL SetLocaleInfo(
LCID Locale,
LCTYPE LCType,
LPWTSTR lpLCData
);
Parameters
- Localidade
[no] Localidade cujas informações definirá a função. A localidade fornece um contexto para a geração mapeamento ou chave de classificação seqüência de caracteres. Um aplicativo pode usar a macro MAKELCID para criar um identificador localidade.
- LCType
[no] Tipo de informações localidade a ser definido pela função. Observe que apenas um LCTYPE pode ser especificado por chamar. Nem todos os LCTYPE Os valores são válido; Consulte a lista de válido LCTYPE Valores a seguinte seção Comentários.
- lpLCData
[no] Ponteiro para uma seqüência de caracteres NULL-Terminated que contém informações de localidade a função será definido. As informações devem estar no especificado LCTYPEdo formato específico.
Return Value
Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar a função GetLastError. A seguinte tabela mostra os possíveis valores para GetLastError.
| Valor | Descrição |
|---|---|
ERROR_INVALID_ACCESS |
Código de acesso inválido. |
ERROR_INVALID_FLAGS |
Os sinalizadores são inválido. |
ERROR_INVALID_PARAMETER |
O parâmetro está incorreto. |
Remarks
A seguinte tabela mostra a LCTYPE Valores que são válido para esta função.
| Valor | Descrição |
|---|---|
LOCALE_ICALENDARTYPE |
Tipo de calendário atual. Consulte LCTYPE Constants para valores exatos. Observação Se uma imagem não tem uma localidade com um tipo de calendário particular, em seguida, SetLocaleInfo retornará ERROR_INVALID_PARAMETER.De exemplo, em dos EUA ou árabe imagem você não pode pedir um calander em japonês. |
LOCALE_ICURRDIGITS |
Número de fracionário dígitos para o local formato monetário. O número máximo de caracteres permitidos para este seqüência de caracteres é 9. |
LOCALE_ICURRENCY |
Modo unidade monetária positivo. O número máximo de caracteres permitidos para este seqüência de caracteres é 2. Consulte LCTYPE Constants para valores exatos. |
LOCALE_IDIGITS |
Número de fracionário dígitos. O número máximo de caracteres permitidos para este seqüência de caracteres é 3. |
LOCALE_IFIRSTDAYOFWEEK |
Especificação para o primeiro dia de uma semana. Consulte LCTYPE Constants para valores exatos. |
LOCALE_IFIRSTWEEKOFYEAR |
Especificação para a primeira semana do ano. Consulte LCTYPE Constants para valores exatos. |
LOCALE_ILZERO |
Especificação para Líderes de zeros em decimal campos. O número máximo de caracteres permitidos para este seqüência de caracteres é 2. Consulte LCTYPE Constants para valores exatos. |
LOCALE_IMEASURE |
Sistema de medida. Esse valor é zero se o sistema métrico (Systéme International d'Unités ou S.I.) for usado e se 1 dos Estados Unidos sistema é usado. O número máximo de caracteres permitidos para este seqüência de caracteres é 2. |
LOCALE_INEGCURR |
Negativo modo unidade monetária. O número máximo de caracteres permitidos para este seqüência de caracteres é 3. Consulte LCTYPE Constants para valores exatos. |
LOCALE_INEGNUMBER |
Modo número negativo. Consulte LCTYPE Constants para valores exatos. |
LOCALE_IPAPERSIZE |
Tamanho de papel padrão associado com a localidade. |
LOCALE_ITIME |
Especificação de formato Tempo. O número máximo de caracteres permitidos para este seqüência de caracteres é 2. Consulte LCTYPE Constants para valores exatos. |
LOCALE_S1159 |
Seqüência de caracteres para o designador AM. |
LOCALE_S2359 |
Seqüência de caracteres para o designador PM. |
LOCALE_SCURRENCY |
Seqüência de caracteres usada como o local símbolo monetário. |
LOCALE_SDATE |
Caractere (s) para o separador de data. |
LOCALE_SDECIMAL |
Caractere (s) usado como a separador decimal. |
LOCALE_SGROUPING |
Tamanhos para cada GRUPO de dígitos à esquerda do decimal. Um tamanho explícito é necessária para cada GRUPO; separar ponto-e-vírgula tamanhos. Se o último valor for zero, a acima valor é repetido. Para GRUPO de milhares, especificar 3; zero, de exemplo. |
LOCALE_SLIST |
Caractere (s) usado para separar itens lista. De exemplo, uma vírgula é usada em vários locais. |
LOCALE_SLONGDATE |
Formatação de data por extenso seqüência de caracteres para esta localidade. O seqüência de caracteres podem consistir de uma combinação de dia, mês e ano imagens formato definido na tabela a dia, mês, ano e Era Format Pictures no National Language Support Constantsand os seqüência de caracteres de caracteres entre aspas simples. Caracteres de aspas simples permanecem como determinado. |
LOCALE_SMONDECIMALSEP |
Caractere (s) usado como o separador decimal monetários. |
LOCALE_SMONGROUPING |
Tamanhos para cada GRUPO de monetários dígitos à esquerda do decimal. Um tamanho explícito é necessária para cada GRUPO; separar ponto-e-vírgula tamanhos. Se o último valor for zero, a acima valor é repetido. Para GRUPO de milhares, especificar 3; 0, de exemplo. |
LOCALE_SMONTHOUSANDSEP |
Caractere (s) usado como o separador monetário entre grupos de dígitos à esquerda do decimal. |
LOCALE_SNEGATIVESIGN |
Seqüência de caracteres valor para o sinal negativo. |
LOCALE_SPOSITIVESIGN |
Seqüência de caracteres valor para a assinar positivo. |
LOCALE_SSHORTDATE |
Formatação de data abreviada seqüência de caracteres para esta localidade. O seqüência de caracteres podem consistir de uma combinação de dia, mês e ano imagens formato definido na tabela de dia, mês, ano e Era Format Pictures em National Language Support Constants. |
LOCALE_STHOUSAND |
Caractere (s) usado para separar grupos de dígitos à esquerda do decimal. |
LOCALE_STIME |
Caractere (s) para o separador tempo. |
LOCALE_STIMEFORMAT |
Formatação tempo seqüências de caracteres para esta localidade. O seqüência de caracteres podem consistir de uma combinação da hora, minuto e, segunda imagens formato definidas na tabela de hora, minuto e Second Format Pictures em National Language Support Constants. |
LOCALE_SYEARMONTH |
A formatação Year/Month seqüência de caracteres para a localidade. Esta seqüência de caracteres mostra o formato adequado para um seqüência de caracteres de data que contém somente o ano e o mês. |
Ele só é possível definir dados localidade se a localidade suporta LCType dos dados. Se o tipo não for com suporte para que localidade, o chamar será ignorado e o valor não será definido, apesar tipo de retorno da chamar será non–zero, indicando sucesso. Um exemplo de um chamar que seria provoke esse comportamento está tentando definir o designador AM ou PM, LOCALE_S1159 ou LOCALE_S2359, em uma localidade russo, desde que o sistema tempo Russo só usa um relógio 24 Hour.
Windows CE 1.0 através de 2.01 não oferecem suporte a LOCALE_IPAPERSIZE LCTYPE valor.
Para obter mais informações sobre LCTYPE, consulte LCTYPE Constants.
Requirements
| Header | winnls.h |
| Library | Coreloc.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |