Edit

IContactProperties::GetDate method (icontact.h)

  • Article

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)