WsFileTimeToDateTime-Funktion (webservices.h)

  • Artikel

Übernimmt einen Verweis auf ein FILETIME-Objekt und konvertiert es in ein WS_DATETIME-Objekt . Ein Verweis auf das WS_DATETIME-Objekt wird vom Ausgabeparameter zurückgegeben.

Syntax

HRESULT WsFileTimeToDateTime(
  [in]           const FILETIME *fileTime,
  [out]          WS_DATETIME    *dateTime,
  [in, optional] WS_ERROR       *error
);

Parameter

[in] fileTime

Ein Zeiger auf die zu konvertierende FILETIME-Struktur.

[out] dateTime

Ein Zeiger auf das neue WS_DATETIME-Objekt, das die neu konvertierte Zeit aufweist.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
E_INVALIDARG
 Mindestens ein Argument ist ungültig.
WS_E_INVALID_FORMAT
 Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.

Hinweise

Ein WS_DATETIME kann keine Datumsangaben aus dem Jahr 10000 und darüber hinaus darstellen. Eine FILETIME, die ein Datum später darstellt, führt dazu, dass die Funktion WS_E_INVALID_FORMAT zurückgibt. (Siehe Rückgabewerte für Windows-Webdienste.)

Das Formatfeld des WS_DATETIME wird auf WS_DATETIME_FORMAT_UTC festgelegt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile webservices.h
Bibliothek WebServices.lib
DLL WebServices.dll