Função VarDateFromUdate (oleauto.h)

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

Sintaxe

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

Parâmetros

[in] pudateIn

A data desempacotar.

[in] dwFlags

VAR_VALIDDATE se a data for válida.

[out] pdateOut

A data lotada.

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, VarDateFromUdateEx e VarUdateFromDate. Ele representa uma data descompactada.

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

A função VarDateFromUdate 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.

Chamar VarDateFromUdate tem o mesmo efeito que chamar VarDateFromUdateEx com o LCID 0x0409.

Requisitos

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