PropVariantToVariant-Funktion (propvarutil.h)

  • Artikel

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