Compartilhar via

Função VarDateFromUdateEx (oleauto.h)

  • Artigo

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

Sintaxe

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

Parâmetros

[in] pudateIn

A data desempacotar.

[in] lcid

O identificador de localidade.

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

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

A função VarDateFromUdate aceita datas inválidas e tenta corrigi-las ao resolver para uma hora VARIANT. Somente os dias são fixos, portanto, os valores de mês inválidos resultam em um erro retornado. Os dias são verificados para verificar se eles estão no intervalo de 1 a 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. Por exemplo, uma data inválida, como 29/02/2001, é resolvida para 1/3/2001. Um dia igual a zero é resolvido como o último dia do mês anterior. Por exemplo, uma data inválida, como 0/2/2001, é resolvida para 31/1/2001.

Requisitos

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