Share via


Função SetDynamicTimeZoneInformation (timezoneapi.h)

Define as configurações atuais de fuso horário e horário de verão dinâmico. Essas configurações controlam traduções do UTC (Tempo Universal Coordenado) para a hora local.

Sintaxe

BOOL SetDynamicTimeZoneInformation(
  [in] const DYNAMIC_TIME_ZONE_INFORMATION *lpTimeZoneInformation
);

Parâmetros

[in] lpTimeZoneInformation

Um ponteiro para uma estrutura DYNAMIC_TIME_ZONE_INFORMATION .

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um aplicativo deve ter o privilégio SE_TIME_ZONE_NAME para que essa função tenha êxito. Esse privilégio está desabilitado por padrão. Use a função AdjustTokenPrivileges para habilitar o privilégio antes de chamar SetDynamicTimeZoneInformation e, em seguida, para desabilitar o privilégio após a chamada SetDynamicTimeZoneInformation . Para obter mais informações, confira Executar com privilégios especiais.

Requisitos

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

Confira também

DYNAMIC_TIME_ZONE_INFORMATION

GetDynamicTimeZoneInformation

Funções de tempo