IPOutlookApp::GetTimeZoneInformationFromIndex

This method is not supported in Windows CE Platform Builder 3.0.

Uses a time zone index to get the TIME_ZONE_INFORMATION structure (declared in winbase.h) for the corresponding time zone.

HRESULT GetTimeZoneInformationFromIndex( int iIndex, TIME_ZONE_INFORMATION * ptz )

Parameters

  • iIndex
    [in] The index of the time zone that you want to retrieve.
  • ptz
    [out] Pointer to a TIME_ZONE_INFORMATION structure to receive the indexed time zone parameters.

Return Values

S_OK indicates success. If an error occurs, the appropriate HRESULT value is returned.

Remarks

This function can be called by C/C++ code to get information about a time zone. This structure cannot be used in Visual Basic, because it is not supported by Automation. In Visual Basic, use GetTimeZoneFromIndex to get the ITimeZone object, which can provide all the information contained in a TIME_ZONE_INFORMATION structure.

Code Example [C++]

The following C++ code snippet shows how to get time zone information given a city's time zone index:

void GetTimeZoneInformation(ICity *pCity)
{
TIME_ZONE_INFORMATION tzTimeZone;
long lTimezoneIndex;

// Get the city's time zone index
pCity->get_TimezoneIndex(&lTimezoneIndex);

// Get the time zone
GetTimeZoneInformationFromIndex(lTimezoneIndex, &tzTimeZone);

// Release objects
pCity->Release();
}

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.0 and later pimstore.h    

See Also

IPOutlookApp::Unknown, IPOutlookApp Property Methods, TIME_ZONE_INFORMATION

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.

  • Last updated on