Compartir a través de

Función PropVariantToVariant (propvarutil.h)

  • Artículo

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