Funzione VariantToDosDateTime (propvarutil.h)
Estrae un valore di data e ora in formato MICROSOFT MS-DOS da una struttura VARIANT .
Sintassi
PSSTDAPI VariantToDosDateTime(
[in] REFVARIANT varIn,
[out] WORD *pwDate,
[out] WORD *pwTime
);
Parametri
[in] varIn
Tipo: REFVARIANT
Riferimento a una struttura VARIANT di origine.
[out] pwDate
Tipo: WORD*
Quando termina, questa funzione contiene la parola estratta che rappresenta una data MS-DOS.
[out] pwTime
Tipo: WORD*
Quando questa funzione viene restituita, contiene l'oggetto estratto word che rappresenta un'ora MS-DOS.
Valore restituito
Tipo: HRESULT
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Questa funzione helper viene usata quando l'applicazione chiamante prevede che un valore VARIANT contenga un valore datetime.
Se l'origine VARIANT è di tipo VT_DATE, questa funzione estrae il valore datetime.
Se l'origine VARIANT non è di tipo VT_DATE, la funzione tenta di convertire il valore nella struttura VARIANT nel formato corretto. Se non è possibile eseguire una conversione, VariantToDosDateTime restituisce un codice di errore. Per un elenco delle conversioni possibili, vedere PropVariantChangeType .
Per altre informazioni sui formati di pwDate, pwTime e sul valore datetime di origine, vedere DosDateTimeToVariantTime.
Esempio
Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare VariantToDosDateTime per accedere a un valore datetime in un valore VARIANT.
// 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.
}
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP con SP2, Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 con SP1 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | propvarutil.h |
| Libreria | Propsys.lib |
| DLL | Propsys.dll (versione 6.0 o successiva) |
| Componente ridistribuibile | Windows Desktop Search (WDS) 3.0 |