VarBstrFromDate Function

Converts a date value to a BSTR value.

HRESULT VarBstrFromDate(
  DATE  dateln,
  LCID  lcid,
  unsigned long  dwFlags,
  BSTR   *pbstrOut
);

dateln

[in] The value to coerce.

lcid

[in] For conversions from string and VT_DISPATCH input, the LCID to use for the conversion. For a list of LCIDs, see Supporting Multiple National Languages and Exposing ActiveX Objects.

dwFlags

[in] One or more of the following flags:

Flag

Description

LOCALE_NOUSEROVERRIDE

Uses the system default locale settings, rather than custom locale settings.

VAR_CALENDAR_HIJRI

If set then the Hijri calendar is used. Otherwise the calendar set in the control panel is used.

VAR_CALENDAR_THAI

If set then the Buddhist year is used.

VAR_CALENDAR_GREGORIAN

If set the Gregorian year is used.

VAR_FOURDIGITYEARS

Forces Automation to use 4-digit years instead of 2-digit years.

VAR_TIMEVALUEONLY

Omits the date portion of a VT_DATE and returns only the time. Applies to conversions to or from dates. Not used for VariantChangeType and VariantChangeTypeEx.

VAR_DATEVALUEONLY

Omits the time portion of a VT_DATE and returns only the date. Applies to conversions to or from dates. Not used for VariantChangeType and VariantChangeTypeEx.

pbstrOut

[out] Points to the coerced value.

The return value obtained from the returned HRESULT is one of the following.

Value

Meaning

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 coerced to the specified type.

E_INVALIDARG

One of the arguments is invalid.

E_OUTOFMEMORY

Memory could not be allocated for the conversion.

Show:
© 2014 Microsoft