Compartilhar via

Função EnumTimeFormatsEx (winnls.h)

  • Artigo

Enumera os formatos de tempo disponíveis para uma localidade especificada pelo nome.

Nota O aplicativo deve chamar essa função em preferência para EnumTimeFormats 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 EnumTimeFormatsEx(
  [in]           TIMEFMT_ENUMPROCEX lpTimeFmtEnumProcEx,
  [in, optional] LPCWSTR            lpLocaleName,
  [in]           DWORD              dwFlags,
  [in]           LPARAM             lParam
);

Parâmetros

[in] lpTimeFmtEnumProcEx

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

[in, optional] lpLocaleName

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

[in] dwFlags

O formato de hora. Defina como 0 para usar o formato de tempo longo do usuário atual ou TIME_NOSECONDS (começando com o Windows 7) para usar o formato de tempo curto.

[in] lParam

Um parâmetro fornecido pelo aplicativo a ser passado para a função de retorno de chamada. Isso é 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_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 os formatos de tempo passando ponteiros de cadeia de caracteres de formato de tempo, 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 multi-threaded. O primeiro valor na enumeração é sempre o valor padrão do usuário (substituição). A função continua a enumeração até que o formato da última vez seja encontrado 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

EnumTimeFormats

EnumTimeFormatsProcEx

Suporte à linguagem nacional

Funções de suporte à linguagem nacional