PropVariantToVariant-Funktion (propvarutil.h)

Artikel
03/01/2024

Konvertiert den Inhalt einer PROPVARIANT-Struktur in eine VARIANT-Struktur .

Syntax

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

Parameter

[in] pPropVar

Typ: const PROPVARIANT*

Zeiger auf eine PROPVARIANT-Quellstruktur .

[out] pVar

Typ: VARIANT*

Zeiger auf eine VARIANT-Struktur . Wenn diese Funktion zurückgibt, enthält variant die konvertierten Informationen.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Normalerweise werden die im PROPVARIANT gespeicherten Daten ohne Änderung des Datentyps in variant kopiert. In den folgenden Fällen gibt es jedoch keine direkte VARIANT-Unterstützung für den Datentyp, und sie werden wie gezeigt konvertiert.

Ursprünglicher PROPVARIANTer Typ	Gespeichert als VARIANT-Typ
VT_BLOB, VT_STREAM	VT_UNKNOWN. Das punkVal-Element enthält einen Zeiger auf einen IStream , der die Quelldaten enthält.
VT_LPSTR, VT_LPWSTR, VT_CLSID	VT_BSTR
VT_FILETIME	VT_DATE
VT_VECTOR\|x	VT_ARRAY\|y

Die folgenden Typen können mit dieser Funktion nicht konvertiert werden.

VT_STORAGE
VT_BLOB_OBJECT
VT_STREAMED_OBJECT
VT_STORED_OBJECT
VT_CF
VT_VECTOR | VT_CF

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	propvarutil.h
Bibliothek	Propsys.lib
DLL	Propsys.dll (Version 6.0 oder höher)
Verteilbare Komponente	Windows Desktop Search (WDS) 3.0

Freigeben über