Função VariantToDosDateTime (propvarutil.h)
Extrai um valor de data e hora no formato MS-DOS da Microsoft de uma estrutura VARIANT .
Sintaxe
PSSTDAPI VariantToDosDateTime(
[in] REFVARIANT varIn,
[out] WORD *pwDate,
[out] WORD *pwTime
);
Parâmetros
[in] varIn
Tipo: REFVARIANT
Referência a uma estrutura VARIANT de origem.
[out] pwDate
Tipo: WORD*
Quando essa função retorna, contém o WORD extraído que representa uma data MS-DOS.
[out] pwTime
Tipo: WORD*
Quando essa função retorna, contém o extraído contém o WORD extraído que representa um tempo MS-DOS.
Retornar valor
Tipo: HRESULT
Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Essa função auxiliar é usada quando o aplicativo de chamada espera que uma VARIANT mantenha um valor datetime.
Se o VARIANT de origem for do tipo VT_DATE, essa função extrairá o valor datetime.
Se o VARIANT de origem não for do tipo VT_DATE, a função tentará converter o valor na estrutura VARIANT no formato correto. Se uma conversão não for possível, VariantToDosDateTime retornará um código de falha. Consulte PropVariantChangeType para obter uma lista de conversões possíveis.
Consulte DosDateTimeToVariantTime para obter mais informações sobre os formatos de pwDate, pwTime e o valor datetime de origem.
Exemplos
O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar VariantToDosDateTime para acessar um valor datetime em uma VARIANT.
// VARIANT var;
// Assume variable var is initialize and valid.
// The application expects var to hold a VT_DATE value.
WORD wDate;
WORD wTime;
HRESULT hr = VariantToDosDateTime(var, &wDate, &wTime);
if (SUCCEEDED(hr))
{
// wDate and wTime are now valid.
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | propvarutil.h |
| Biblioteca | Propsys.lib |
| DLL | Propsys.dll (versão 6.0 ou posterior) |
| Redistribuível | Pesquisa da Área de Trabalho do Windows (WDS) 3.0 |