IContactProperties::GetDate method

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(
  LPCWSTR  pszPropertyName,
  DWORD    dwFlags,
  FILETIME *pftDateTime
);

Parameters

pszPropertyName

Type: LPCWSTR

Specifies the property to retrieve.

dwFlags

Type: DWORD

Must be CGD_DEFAULT.

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 zero'ed.
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

   
Windows version Windows Vista [desktop apps only] Windows Server 2003 [desktop apps only]
Target Platform Windows
Header icontact.h (include Contact.h)
DLL Wab32.dll (Version 6.0 or later)