timezoneapi.h

// begin_1_0

/******************************************************************************** * * * timezoneapi.h -- ApiSet Contract for api-ms-win-core-timezone-l1 * * * * Copyright (c) Microsoft Corporation. All rights reserved. * * * ********************************************************************************/

#ifdef _MSC_VER

#pragma once

#endif // _MSC_VER

#ifndef _TIMEZONEAPI_H_

#define _TIMEZONEAPI_H_

#include <apiset.h>

#include <apisetcconv.h>

#include <minwindef.h>

#include <minwinbase.h>

#ifdef __cplusplus

extern

"C"

{

#endif

// end_1_0

#pragma region Application Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

// begin_1_0

#define TIME_ZONE_ID_INVALID ((DWORD)0xFFFFFFFF)

typedef

struct

_TIME_ZONE_INFORMATION

{

LONG

Bias

;

WCHAR

StandardName

[

];

SYSTEMTIME

StandardDate

;

LONG

StandardBias

;

WCHAR

DaylightName

[

];

SYSTEMTIME

DaylightDate

;

LONG

DaylightBias

; }

TIME_ZONE_INFORMATION

, *

PTIME_ZONE_INFORMATION

, *

LPTIME_ZONE_INFORMATION

;

typedef

struct

_TIME_DYNAMIC_ZONE_INFORMATION

{

LONG

Bias

;

WCHAR

StandardName

[

];

SYSTEMTIME

StandardDate

;

LONG

StandardBias

;

WCHAR

DaylightName

[

];

SYSTEMTIME

DaylightDate

;

LONG

DaylightBias

;

WCHAR

TimeZoneKeyName

[

128

];

BOOLEAN

DynamicDaylightTimeDisabled

; }

DYNAMIC_TIME_ZONE_INFORMATION

, *

PDYNAMIC_TIME_ZONE_INFORMATION

;

WINBASEAPI

__declspec

(dllimport)

_Success_(return != FALSE)

BOOL

WINAPI

__stdcall

SystemTimeToTzSpecificLocalTime

(

_In_opt_ CONST TIME_ZONE_INFORMATION* lpTimeZoneInformation,

const

TIME_ZONE_INFORMATION

lpTimeZoneInformation

_In_ CONST SYSTEMTIME* lpUniversalTime,

const

SYSTEMTIME

lpUniversalTime

_Out_ LPSYSTEMTIME lpLocalTime

LPSYSTEMTIME

lpLocalTime

);

WINBASEAPI

__declspec

(dllimport)

_Success_(return != FALSE)

BOOL

WINAPI

__stdcall

TzSpecificLocalTimeToSystemTime

(

_In_opt_ CONST TIME_ZONE_INFORMATION* lpTimeZoneInformation,

const

TIME_ZONE_INFORMATION

lpTimeZoneInformation

_In_ CONST SYSTEMTIME* lpLocalTime,

const

SYSTEMTIME

lpLocalTime

_Out_ LPSYSTEMTIME lpUniversalTime

LPSYSTEMTIME

lpUniversalTime

);

WINBASEAPI

__declspec

(dllimport)

_Success_(return != FALSE)

BOOL

WINAPI

__stdcall

FileTimeToSystemTime

(

_In_ CONST FILETIME* lpFileTime,

const

FILETIME

lpFileTime

_Out_ LPSYSTEMTIME lpSystemTime

LPSYSTEMTIME

lpSystemTime

);

WINBASEAPI

__declspec

(dllimport)

_Success_(return != FALSE)

BOOL

WINAPI

__stdcall

SystemTimeToFileTime

(

_In_ CONST SYSTEMTIME* lpSystemTime,

const

SYSTEMTIME

lpSystemTime

_Out_ LPFILETIME lpFileTime

LPFILETIME

lpFileTime

);

WINBASEAPI

__declspec

(dllimport)

_Success_(return != TIME_ZONE_ID_INVALID)

DWORD

WINAPI

__stdcall

GetTimeZoneInformation

(

_Out_ LPTIME_ZONE_INFORMATION lpTimeZoneInformation

LPTIME_ZONE_INFORMATION

lpTimeZoneInformation

);

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Desktop Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM)

WINBASEAPI

__declspec

(dllimport)

BOOL

WINAPI

__stdcall

SetTimeZoneInformation

(

_In_ CONST TIME_ZONE_INFORMATION* lpTimeZoneInformation

const

TIME_ZONE_INFORMATION

lpTimeZoneInformation

);

#if (_WIN32_WINNT >= 0x0600)

WINBASEAPI

__declspec

(dllimport)

BOOL

WINAPI

__stdcall

SetDynamicTimeZoneInformation

(

_In_ CONST DYNAMIC_TIME_ZONE_INFORMATION* lpTimeZoneInformation

const

DYNAMIC_TIME_ZONE_INFORMATION

lpTimeZoneInformation

);

#endif // _WIN32_WINNT >= 0x0600

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_DESKTOP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion #pragma region Application Family or OneCore Family

#if WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM)

#if (_WIN32_WINNT >= 0x0600)

WINBASEAPI

__declspec

(dllimport)

_Success_(return != TIME_ZONE_ID_INVALID)

DWORD

WINAPI

__stdcall

GetDynamicTimeZoneInformation

(

_Out_ PDYNAMIC_TIME_ZONE_INFORMATION pTimeZoneInformation

PDYNAMIC_TIME_ZONE_INFORMATION

pTimeZoneInformation

);

#endif // _WIN32_WINNT >= 0x0600

#if (_WIN32_WINNT >= 0x0601)

_Success_(return != FALSE)

BOOL

WINAPI

__stdcall

GetTimeZoneInformationForYear

(

_In_ USHORT wYear,

USHORT

wYear

_In_opt_ PDYNAMIC_TIME_ZONE_INFORMATION pdtzi,

PDYNAMIC_TIME_ZONE_INFORMATION

pdtzi

_Out_ LPTIME_ZONE_INFORMATION ptzi

LPTIME_ZONE_INFORMATION

ptzi

);

#endif // _WIN32_WINNT >= 0x0601

// end_1_0

#if (_WIN32_WINNT >= _WIN32_WINNT_WIN8)

WINBASEAPI

__declspec

(dllimport)

_Success_(return == ERROR_SUCCESS)

DWORD

WINAPI

__stdcall

EnumDynamicTimeZoneInformation

(

_In_ CONST DWORD dwIndex,

const

DWORD

dwIndex

_Out_ PDYNAMIC_TIME_ZONE_INFORMATION lpTimeZoneInformation

PDYNAMIC_TIME_ZONE_INFORMATION

lpTimeZoneInformation

);

WINBASEAPI

__declspec

(dllimport)

_Success_(return == ERROR_SUCCESS)

DWORD

WINAPI

__stdcall

GetDynamicTimeZoneInformationEffectiveYears

(

_In_ CONST PDYNAMIC_TIME_ZONE_INFORMATION lpTimeZoneInformation,

const

PDYNAMIC_TIME_ZONE_INFORMATION

lpTimeZoneInformation

_Out_ LPDWORD FirstYear,

LPDWORD

FirstYear

_Out_ LPDWORD LastYear

LPDWORD

LastYear

);

WINBASEAPI

__declspec

(dllimport)

_Success_(return != FALSE)

BOOL

WINAPI

__stdcall

SystemTimeToTzSpecificLocalTimeEx

(

_In_opt_ CONST DYNAMIC_TIME_ZONE_INFORMATION* lpTimeZoneInformation,

const

DYNAMIC_TIME_ZONE_INFORMATION

lpTimeZoneInformation

_In_ CONST SYSTEMTIME* lpUniversalTime,

const

SYSTEMTIME

lpUniversalTime

_Out_ LPSYSTEMTIME lpLocalTime

LPSYSTEMTIME

lpLocalTime

);

WINBASEAPI

__declspec

(dllimport)

_Success_(return != FALSE)

BOOL

WINAPI

__stdcall

TzSpecificLocalTimeToSystemTimeEx

(

_In_opt_ CONST DYNAMIC_TIME_ZONE_INFORMATION* lpTimeZoneInformation,

const

DYNAMIC_TIME_ZONE_INFORMATION

lpTimeZoneInformation

_In_ CONST SYSTEMTIME* lpLocalTime,

const

SYSTEMTIME

lpLocalTime

_Out_ LPSYSTEMTIME lpUniversalTime

LPSYSTEMTIME

lpUniversalTime

);

#endif /* (_WIN32_WINNT >= _WIN32_WINNT_WIN8) */

#if (NTDDI_VERSION >= NTDDI_WIN10_RS5)

WINBASEAPI

__declspec

(dllimport)

_Success_(return != FALSE)

BOOL

WINAPI

__stdcall

LocalFileTimeToLocalSystemTime

(

_In_opt_ CONST TIME_ZONE_INFORMATION* timeZoneInformation,

const

TIME_ZONE_INFORMATION

timeZoneInformation

_In_ CONST FILETIME* localFileTime,

const

FILETIME

localFileTime

_Out_ SYSTEMTIME* localSystemTime

SYSTEMTIME

localSystemTime

);

WINBASEAPI

__declspec

(dllimport)

_Success_(return != FALSE)

BOOL

WINAPI

__stdcall

LocalSystemTimeToLocalFileTime

(

_In_opt_ CONST TIME_ZONE_INFORMATION* timeZoneInformation,

const

TIME_ZONE_INFORMATION

timeZoneInformation

_In_ CONST SYSTEMTIME* localSystemTime,

const

SYSTEMTIME

localSystemTime

_Out_ FILETIME* localFileTime

FILETIME

localFileTime

);

#endif /* (NTDDI_VERSION >= NTDDI_WIN10_RS5) */

#endif /* WINAPI_FAMILY_PARTITION(WINAPI_PARTITION_APP | WINAPI_PARTITION_SYSTEM) */

#pragma endregion

// begin_1_0

#ifdef __cplusplus

}

#endif

#endif // _TIMEZONEAPI_H_

// end_1_0