Función PropVariantToVariant (propvarutil.h)

Convierte el contenido de una estructura PROPVARIANT en una estructura VARIANT .

Sintaxis

PSSTDAPI PropVariantToVariant(
  [in]  const PROPVARIANT *pPropVar,
  [out] VARIANT           *pVar
);

Parámetros

[in] pPropVar

Tipo: const PROPVARIANT*

Puntero a una estructura PROPVARIANT de origen.

[out] pVar

Tipo: VARIANT*

Puntero a una estructura VARIANT . Cuando se devuelve esta función, VARIANT contiene la información convertida.

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

Normalmente, los datos almacenados en PROPVARIANT se copian en variant sin un cambio de tipo de datos. Sin embargo, en los siguientes casos, no hay compatibilidad directa con VARIANT para el tipo de datos y se convierten como se muestra.

Tipo PROPVARIANT original	Almacenado como tipo VARIANT
VT_BLOB, VT_STREAM	VT_UNKNOWN. El miembro punkVal contendrá un puntero a un IStream que contenga los datos de origen.
VT_LPSTR, VT_LPWSTR, VT_CLSID	VT_BSTR
VT_FILETIME	VT_DATE
VT_VECTOR|x	VT_ARRAY|y

 

Los tipos siguientes no se pueden convertir con esta función.

• VT_STORAGE
• VT_BLOB_OBJECT
• VT_STREAMED_OBJECT
• VT_STORED_OBJECT
• VT_CF
• VT_VECTOR | VT_CF

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [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	Búsqueda de escritorio de Windows (WDS) 3.0