VarBstrFromDate (Windows Embedded CE 6.0)

1/6/2010

This function converts variant data types to BSTR from DATE.

Syntax

HRESULT VarBstrFromDate(
  DATE dateIn,
  LCID lcid,
  ULONG dwFlags,
  BSTR pbstrOut
);

lcid
[in] For conversions from string and VT_DISPATCH input, the LCID to use for the conversion.

dwFlags
[in] Specifies a value made from one or more flags.

The following flags can be set for this parameter.

Flag	Description
LOCALE_NOUSEROVERRIDE	Uses the system default locale settings, rather than custom locale settings.
VAR_CALENDAR_HIJRI	If set, the Hijri calendar is used. Otherwise, the calendar sent in Control Panel is used.
VAR_CALENDAR_THAI	This flag is not supported in Windows Embedded CE.
VAR_CALENDAR_GREGORIAN	This flag is not supported in Windows Embedded CE.
VAR_FOURDIGITYEARS	This flag is not supported in Windows Embedded CE.
VAR_TIMEVALUEONLY	This flag is not supported in Windows Embedded CE.
VAR_DATEVALUEONLY	This flag is not supported in Windows Embedded CE.

pbstrOut
[out] Points to the converted value.

The following flags can be set for this parameter.

Flag	Description
LOCALE_NOUSEROVERRIDE	Uses the system default locale settings, rather than custom locale settings.
VAR_CALENDAR_HJRI	If set, the Hijri calendar is used. Otherwise, the calendar sent in Control Panel is used.
VAR_DATEVALUEONLY	Omits the time portion of a VT_DATE and retrieves only the date. Applies to conversions to or from dates. Not used for VariantChangeType and VariantChangeTypeEx.
VAR_TIMEVALUEONLY	Omits the date portion of a VT_DATE and retrieves only the time. Applies to conversions to or from dates. Not used for VariantChangeType and VariantChangeTypeEx.

Returns the HRESULT values shown in the following table.

Value	Description
S_OK	Success.
DISP_E_BADVARTYPE	The input parameter is not a valid type of variant.
DISP_E_OVERFLOW	The data pointed to by the output parameter does not fit in the destination type.
DISP_E_TYPEMISMATCH	The argument could not be converted to the specified type.
E_INVALIDARG	An argument is invalid.
E_OUTOFMEMORY	Memory could not be allocated for the conversion.

Passing invalid (and under some circumstances NULL) pointers to this function causes an unexpected termination of the application.