Funzione VariantToDosDateTime (propvarutil.h)

Articolo
03/05/2024

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