IContactProperties::GetDate method (icontact.h)

Retrieves the date and time value at a specified property into a caller's FILETIME structure. All times are stored and returned as Coordinated Universal Time (UTC).

Syntax

HRESULT GetDate(
  [in]      LPCWSTR  pszPropertyName,
  [in]      DWORD    dwFlags,
  [in, out] FILETIME *pftDateTime
);

Parameters

[in] pszPropertyName

Type: LPCWSTR

Specifies the property to retrieve.

[in] dwFlags

Type: DWORD

Must be CGD_DEFAULT.

[in, out] pftDateTime

Type: FILETIME*

Specifies caller-allocated FILETIME structure.

Return value

Type: HRESULT

Returns one of the following values:

Return code	Description
S_OK	pftDateTime contains a valid FILETIME.
S_FALSE	The property has been present in the past but its value has been removed. The FILETIME has been zeroed.
ERROR_PATH_NOT_FOUND	No data found for this property name.

Remarks

To retrieve a single level property, set pszPropertyName to the property name.

To retrieve a value from a multi-value (hierarchical) property, include the desired index as part of pszPropertyName using the form: toplevel/secondlevel[1]/thirdlevel. NOTE: the first element of a set is index 1, so index [0] is invalid.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	icontact.h (include Contact.h)
DLL	Wab32.dll (Version 6.0 or later)