Função EnumDateFormatsExEx (winnls.h)

  • Artigo

Enumera os formatos de data, data curta ou ano/mês que estão disponíveis para uma localidade especificada pelo nome.

Nota O aplicativo deve chamar essa função em preferência para EnumDateFormats ou EnumDateFormatsEx se projetado para ser executado somente no Windows Vista e posterior.

 
Nota Essa função pode enumerar dados que são alterados entre versões, por exemplo, devido a uma localidade personalizada. Se o aplicativo precisar persistir ou transmitir dados, consulte Usando dados de localidade persistente.
 

Sintaxe

BOOL EnumDateFormatsExEx(
  [in]           DATEFMT_ENUMPROCEXEX lpDateFmtEnumProcExEx,
  [in, optional] LPCWSTR              lpLocaleName,
  [in]           DWORD                dwFlags,
  [in]           LPARAM               lParam
);

Parâmetros

[in] lpDateFmtEnumProcExEx

Ponteiro para uma função de retorno de chamada definida pelo aplicativo. Para obter mais informações, consulte EnumDateFormatsProcExEx.

[in, optional] lpLocaleName

Ponteiro para um nome de localidade ou um dos seguintes valores predefinidos.

[in] dwFlags

Sinalizador especificando formatos de data. O aplicativo pode fornecer um dos valores a seguir ou a constante LOCALE_USE_CP_ACP .

Valor Significado
DATE_SHORTDATE
 Use formatos de data curta. Esse valor não pode ser usado com nenhum dos outros valores de sinalizador.
DATE_LONGDATE
 Use formatos de data longa. Esse valor não pode ser usado com nenhum dos outros valores de sinalizador.
DATE_YEARMONTH
 Use formatos ano/mês. Esse valor não pode ser usado com nenhum dos outros valores de sinalizador.
DATE_MONTHDAY
 Use formatos de mês/dia. Esse valor não pode ser usado com nenhum dos outros valores de sinalizador.

[in] lParam

Um parâmetro fornecido pelo aplicativo para passar para a função de retorno de chamada. Esse valor é especialmente útil para aplicativos com vários threads.

Retornar valor

Retorna um valor diferente de zero se tiver êxito ou 0 de outra forma. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:

  • ERROR_BADDB. A função não pôde acessar os dados. Normalmente, essa situação não deve ocorrer e normalmente indica uma instalação incorreta, um problema de disco ou similar.
  • ERROR_INVALID_FLAGS. Os valores fornecidos para sinalizadores não eram válidos.
  • ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Comentários

Nota Essa API está sendo atualizada para dar suporte à alteração da era japonesa de maio de 2019. Se o aplicativo der suporte ao calendário japonês, você deverá validar se ele lida corretamente com a nova era. Confira Preparar seu aplicativo para a alteração da era japonesa para obter mais informações.
 
A função enumera os formatos de data passando ponteiros de cadeia de caracteres de formato de data, um de cada vez, para a função de retorno de chamada definida pelo aplicativo especificada, juntamente com uma constante definida pelo aplicativo que é útil para aplicativos com vários threads. Esse processo continua até que EnumDateFormatsExex encontre o formato da última data ou a função de retorno de chamada retorne FALSE.

Começando no Windows 8: se o aplicativo passar marcas de idioma para essa função do namespace Windows.Globalization, ele deverá primeiro converter as marcas chamando ResolveLocaleName.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winnls.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

EnumDateFormats

EnumDateFormatsEx

EnumDateFormatsProcExEx

Suporte à linguagem nacional

Funções de suporte à linguagem nacional