Função VarUdateFromDate (oleauto.h)

Converte uma hora e uma data convertidas do formato variante para o formato MS-DOS.

Sintaxe

HRESULT VarUdateFromDate(
  [in]  DATE  dateIn,
  [in]  ULONG dwFlags,
  [out] UDATE *pudateOut
);

Parâmetros

[in] dateIn

A data lotada.

[in] dwFlags

Definido para calendários alternativos, como Hijri, polonês e russo.

[out] pudateOut

A data desempacotar.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno	Descrição
S_OK	Êxito.
E_INVALIDARG	Um dos argumentos não é válido.
E_OUTOFMEMORY	Memória insuficiente para concluir a operação.

Comentários

A estrutura UDATE é usada com VarDateFromUdate e VarUdateFromDate. Ele representa uma data "descompactada".

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

A função VarUdateFromDate aceitará datas inválidas e tentará corrigi-las ao resolver para uma hora VARIANT. Por exemplo, uma data inválida, como 29/02/2001, resolve para 1/3/2001. Somente os dias são fixos, portanto, os valores de mês inválidos resultam em um erro retornado. Os dias estão marcados para estar entre 1 e 31. Dias e dias negativos maiores que 31 resultam em um erro. Um dia menor que 31, mas maior que o dia máximo nesse mês tem o dia promovido para o dia apropriado do mês seguinte. Um dia igual a zero é resolvido como o último dia do mês anterior. Por exemplo, uma data inválida, como 0/2/2001, resolve a 31/1/2001.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	oleauto.h
Biblioteca	OleAut32.lib
DLL	OleAut32.dll