Funzione VarDateFromUdate (oleauto.h)

Articolo
03/05/2024

Converte un'ora e una data convertita dal formato MS-DOS in formato variant.

Sintassi

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

Parametri

[in] pudateIn

Data non compressa.

[in] dwFlags

VAR_VALIDDATE se la data è valida.

[out] pdateOut

Data di pacchetto.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_INVALIDARG	Uno degli argomenti non è valido.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.

Commenti

La struttura UDATE viene usata con VarDateFromUdate, VarDateFromUdateEx e VarUdateFromDate. Rappresenta una data non compressa.

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

La funzione VarDateFromUdate accetta le date non valide e prova a correggerle quando si risolve in un'ora VARIANT. Ad esempio, una data non valida, ad esempio 2/29/2001, verrà risolta fino al 3/1/2001. Solo i giorni vengono corretti, quindi i valori del mese non validi generano un errore restituito. I giorni vengono controllati tra 1 e 31. Giorni negativi e giorni superiori a 31 generano un errore. Un giorno minore di 31 ma maggiore del giorno massimo in quel mese ha il giorno promosso al giorno appropriato del mese successivo. Un giorno uguale a zero viene risolto come ultimo giorno del mese precedente. Ad esempio, le date non valide, ad esempio 2/0/2001, verranno risolte a 1/31/2001.

La chiamata a VarDateFromUdate ha lo stesso effetto della chiamata a VarDateFromUdateEx con l'0x0409 LCID.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	oleauto.h
Libreria	OleAut32.lib
DLL	OleAut32.dll

Condividi tramite