Función VariantToDosDateTime (propvarutil.h)
Extrae un valor de fecha y hora en formato MS-DOS de Microsoft de una estructura VARIANT .
Sintaxis
PSSTDAPI VariantToDosDateTime(
[in] REFVARIANT varIn,
[out] WORD *pwDate,
[out] WORD *pwTime
);
Parámetros
[in] varIn
Tipo: REFVARIANT
Referencia a una estructura VARIANT de origen.
[out] pwDate
Tipo: WORD*
Cuando se devuelve esta función, contiene el WORD extraído que representa una fecha de MS-DOS.
[out] pwTime
Tipo: WORD*
Cuando se devuelve esta función, contiene el extraído contiene el WORD extraído que representa una hora de MS-DOS.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Esta función auxiliar se usa cuando la aplicación que realiza la llamada espera que variant contenga un valor datetime.
Si el valor VARIANT de origen es de tipo VT_DATE, esta función extrae el valor datetime.
Si el valor VARIANT de origen no es de tipo VT_DATE, la función intenta convertir el valor de la estructura VARIANT en el formato correcto. Si no es posible una conversión, VariantToDosDateTime devuelve un código de error. Consulte PropVariantChangeType para obtener una lista de las posibles conversiones.
Consulte DosDateTimeToVariantTime para obtener más información sobre los formatos de pwDate, pwTime y el valor datetime de origen.
Ejemplos
En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar VariantToDosDateTime para tener acceso a un valor datetime en un 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 | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | propvarutil.h |
| Library | Propsys.lib |
| Archivo DLL | Propsys.dll (versión 6.0 o posterior) |
| Redistribuible | Windows Desktop Search (WDS) 3.0 |