Funzione PropVariantToVariant (propvarutil.h)

Articolo
03/01/2024

Converte il contenuto di una struttura PROPVARIANT in una struttura VARIANT .

Sintassi

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

Parametri

[in] pPropVar

Tipo: const PROPVARIANT*

Puntatore a una struttura PROPVARIANT di origine.

[out] pVar

Tipo: VARIANT*

Puntatore a una struttura VARIANT . Quando questa funzione restituisce, l'oggetto VARIANT contiene le informazioni convertite.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

In genere, i dati archiviati nel PROPVARIANT vengono copiati in VARIANT senza una modifica del tipo di dati. Nei casi seguenti, tuttavia, non è disponibile alcun supporto VARIANT diretto per il tipo di dati e vengono convertiti come illustrato.

Tipo PROPVARIANT originale	Archiviato come tipo VARIANT
VT_BLOB, VT_STREAM	VT_UNKNOWN. Il membro punkVal conterrà un puntatore a un IStream che contiene i dati di origine.
VT_LPSTR, VT_LPWSTR, VT_CLSID	VT_BSTR
VT_FILETIME	VT_DATE
VT_VECTOR\|x	VT_ARRAY\|y

I tipi seguenti non possono essere convertiti con questa funzione.

VT_STORAGE
VT_BLOB_OBJECT
VT_STREAMED_OBJECT
VT_STORED_OBJECT
VT_CF
VT_VECTOR | VT_CF

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propvarutil.h
Libreria	Propsys.lib
DLL	Propsys.dll (versione 6.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Condividi tramite