Share via


Função VarBstrFromDate (oleauto.h)

Converte um valor de data em um valor BSTR.

Sintaxe

HRESULT VarBstrFromDate(
  [in]  DATE  dateIn,
  [in]  LCID  lcid,
  [in]  ULONG dwFlags,
  [out] BSTR  *pbstrOut
);

Parâmetros

[in] dateIn

O valor a ser convertido.

[in] lcid

O identificador de localidade.

[in] dwFlags

Um ou mais dos sinalizadores a seguir.

Valor Significado
LOCALE_NOUSEROVERRIDE
Usa as configurações de localidade padrão do sistema, em vez de configurações de localidade personalizadas.
VAR_CALENDAR_HIJRI
Se definido, o calendário Hijri será usado. Caso contrário, o conjunto de calendários no painel de controle será usado.
VAR_CALENDAR_THAI
Se definido, então o ano budista é usado.
VAR_CALENDAR_GREGORIAN
Se definido, o ano gregoriano será usado.
VAR_FOURDIGITYEARS
Use anos de 4 dígitos em vez de anos de 2 dígitos.
VAR_TIMEVALUEONLY
Omite a parte de data de um VT_DATE e retorna apenas a hora. Aplica-se a conversões de ou para datas.
VAR_DATEVALUEONLY
Omite a parte de hora de um VT_DATE e retorna apenas a data. Aplica-se a conversões de ou para datas.

[out] pbstrOut

O valor resultante.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
DISP_E_BADVARTYPE
O parâmetro de entrada não é um tipo válido de variante.
DISP_E_OVERFLOW
Os dados apontados pelo parâmetro de saída não se encaixam no tipo de destino.
DISP_E_TYPEMISMATCH
O argumento não pôde ser coagido para o tipo especificado.
E_INVALIDARG
Um dos argumentos não é válido.
E_OUTOFMEMORY
Memória insuficiente para concluir a operação.

Requisitos

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