VarDateFromUdateEx-Funktion (oleauto.h)

  • Artikel

Konvertiert eine Vom MS-DOS-Format konvertierte Uhrzeit und ein Datum in ein Variantenformat.

Syntax

HRESULT VarDateFromUdateEx(
  [in]  UDATE *pudateIn,
  [in]  LCID  lcid,
  [in]  ULONG dwFlags,
  [out] DATE  *pdateOut
);

Parameter

[in] pudateIn

Das unverpackte Datum.

[in] lcid

Der Gebietsschemabezeichner.

[in] dwFlags

VAR_VALIDDATE, ob das Datum gültig ist.

[out] pdateOut

Das gepackte Datum.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_INVALIDARG
 Eines der Argumente ist ungültig.
E_OUTOFMEMORY
 Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.

Hinweise

Die UDATE-Struktur wird mit VarDateFromUdateEx, VarDateFromUdate und VarUdateFromDate verwendet. Es stellt ein unverpacktes Datum dar.

typedef struct {
    SYSTEMTIME st;
    USHORT  wDayOfYear;
} UDATE;

Die VarDateFromUdate-Funktion akzeptiert ungültige Datumsangaben und versucht, diese beim Auflösen in eine VARIANT-Zeit zu korrigieren. Es werden nur Tage behoben, sodass ungültige Monatswerte zu einem Fehler führen. Die Tage werden überprüft, um zu überprüfen, ob sie sich im Bereich von 1 bis 31 befinden. Negative Tage und Tage, die größer als 31 sind, führen zu einem Fehler. Ein Tag, der kleiner als 31 ist, aber größer als der maximale Tag in diesem Monat ist, wird auf den entsprechenden Tag des nächsten Monats heraufgestuft. Beispielsweise wird ein ungültiges Datum wie der 29.02.2001 in den 01.03.2001 aufgelöst. Ein Tag gleich 0 (null) wird als letzter Tag des vorherigen Monats aufgelöst. Beispielsweise wird ein ungültiges Datum wie der 0.02.2001 in den 31.01.2001 aufgelöst.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile oleauto.h
Bibliothek OleAut32.lib
DLL OleAut32.dll