InitPropVariantVectorFromPropVariant-Funktion (propvarutil.h)

Artikel
03/06/2024

Initialisiert ein Vektorelement in einer PROPVARIANT-Struktur mit einem Wert, der in einem anderen PROPVARIANT gespeichert ist.

Syntax

PSSTDAPI InitPropVariantVectorFromPropVariant(
  [in]  REFPROPVARIANT propvarSingle,
  [out] PROPVARIANT    *ppropvarVector
);

Parameter

[in] propvarSingle

Typ: REFPROPVARIANT

Verweis auf die PROPVARIANT-Quellstruktur , die einen einzelnen Wert enthält.

[out] ppropvarVector

Typ: PROPVARIANT*

Wenn diese Funktion zurückgibt, enthält die initialisierte PROPVARIANT-Struktur .

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Funktion wird verwendet, um eine PROPVARIANT-Struktur , die einen einzelnen Wert enthält, in einen Vektorwert zu konvertieren.

Bei einfachen Quelltypen initialisiert diese Funktion propvariant als Vektor eines Elements.

Bei einer Quelle, die eine Zeichenfolge enthält, initialisiert diese Funktion PROPVARIANT mit null oder mehr Teilzeichenfolgen, die aus der Quellzeichenfolge stammen, und behandelt Semikolons als Trennzeichen. Weitere Informationen finden Sie unter InitPropVariantFromStringAsVector .

Die folgenden Eingabetypen werden unterstützt:

VT_I2
VT_UI2
VT_I4
VT_UI4
VT_I8
VT_UI8
VT_R8
VT_BOOL
VT_DATE
VT_FILETIME
VT_BSTR
VT_LPWSTR

Weitere Typen können in Zukunft unterstützt werden.

Beispiele

Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird die Verwendung von InitPropVariantVectorFromPropVariant veranschaulicht.

// PROPVARIANT propvarSource;
// Assume propvarSource is initialized and valid.

if (PropVariantGetElementCount(propvarSource) == 1)
{
    PROPVARIANT propvar;

    HRESULT hr = InitPropVariantVectorFromPropVariant(propvarSource, &propvar);

    if (SUCCEEDED(hr))
    {
       // propvar now is valid and is either VT_EMPTY or contains a vector.
       PropVariantClear(&propvar);
    }

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2, Windows Vista [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

Weitere Informationen

InitPropVariantFromStringAsVector

PropVariantGetElem

PropVariantGetElementCount

Freigeben über