VariantToDosDateTime-Funktion (propvarutil.h)
Extrahiert einen Datums- und Uhrzeitwert im Microsoft MS-DOS-Format aus einer VARIANT-Struktur .
Syntax
PSSTDAPI VariantToDosDateTime(
[in] REFVARIANT varIn,
[out] WORD *pwDate,
[out] WORD *pwTime
);
Parameter
[in] varIn
Typ: REFVARIANT
Verweis auf eine VARIANT-Quellstruktur .
[out] pwDate
Typ: WORD*
Wenn diese Funktion zurückgibt, enthält das extrahierte WORD , das ein MS-DOS-Datum darstellt.
[out] pwTime
Typ: WORD*
Wenn diese Funktion zurückgibt, enthält das extrahierte enthält das extrahierte WORD , das eine MS-DOS-Zeit darstellt.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Hilfsfunktion wird verwendet, wenn die aufrufende Anwendung erwartet, dass ein VARIANT einen datetime-Wert enthält.
Wenn die VARIANT-Quelle vom Typ VT_DATE ist, extrahiert diese Funktion den datetime-Wert.
Wenn die VARIANT-Quelle nicht vom Typ VT_DATE ist, versucht die Funktion, den Wert in der VARIANT-Struktur in das richtige Format zu konvertieren. Wenn eine Konvertierung nicht möglich ist, gibt VariantToDosDateTime einen Fehlercode zurück. Eine Liste möglicher Konvertierungen finden Sie unter PropVariantChangeType .
Weitere Informationen zu den Formaten von pwDate, pwTime und dem Quellwert datetime finden Sie unter DosDateTimeToVariantTime.
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie Sie VariantToDosDateTime verwenden, um auf einen datetime-Wert in einem VARIANT-Wert zuzugreifen.
// VARIANT var;
// Assume variable var is initialize and valid.
// The application expects var to hold a VT_DATE value.
WORD wDate;
WORD wTime;
HRESULT hr = VariantToDosDateTime(var, &wDate, &wTime);
if (SUCCEEDED(hr))
{
// wDate and wTime are now valid.
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2, Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | propvarutil.h |
| Bibliothek | Propsys.lib |
| DLL | Propsys.dll (Version 6.0 oder höher) |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |