Função EnumDateFormatsExA (winnls.h)
Enumera os formatos de data longa, data abreviada ou ano/mês disponíveis para uma localidade especificada.
Sintaxe
BOOL EnumDateFormatsExA(
[in] DATEFMT_ENUMPROCEXA lpDateFmtEnumProcEx,
[in] LCID Locale,
[in] DWORD dwFlags
);
Parâmetros
[in] lpDateFmtEnumProcEx
Ponteiro para uma função de retorno de chamada definida pelo aplicativo. Para obter mais informações, consulte EnumDateFormatsProcEx.
[in] Locale
Identificador de localidade que especifica a localidade para a qual as informações de formato de data serão recuperadas. Você pode usar a macro MAKELCID para criar um identificador ou usar um dos valores predefinidos a seguir.
Windows Vista e posterior: Também há suporte para os seguintes identificadores de localidade personalizados.[in] dwFlags
Sinalizador especificando formatos de data. Para obter definições detalhadas, consulte o parâmetro dwFlags de EnumDateFormatsExEx.
Retornar valor
Retornará um valor diferente de zero se tiver êxito ou 0 caso contrário. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:
- 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
Essa função enumera todos os formatos de data para a localidade especificada, incluindo calendários alternativos, se houver. No entanto, o identificador de calendário não é enumerado junto com o formato de data, dificultando o uso de formatos para localidades com calendários alternativos.
Essa função pode enumerar dados de localidades personalizadas. Não há garantia de que os dados sejam iguais de computador para computador ou entre execuções de um aplicativo. Se o aplicativo precisar persistir ou transmitir dados, consulte Usando dados de localidade persistente.
Quando a versão ANSI dessa função é usada com um identificador de localidade somente Unicode, a função pode ser bem-sucedida porque o sistema operacional usa a página de código do sistema. No entanto, os caracteres indefinidos na página de código do sistema aparecem na cadeia de caracteres como um ponto de interrogação (?).
O aplicativo deve usar EnumDateFormatsEx (em vez de EnumDateFormats) para enumerar formatos de data para localidades com calendários alternativos.
Observação
O cabeçalho winnls.h define EnumDateFormatsEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winnls.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |