InitPropVariantFromStringAsVector-Funktion (propvarutil.h)

Initialisiert eine PROPVARIANT-Struktur aus einer angegebenen Zeichenfolge. Die Zeichenfolge wird als durch Semikolon getrennte Liste analysiert (z. B. "A; B; C").

Syntax

PSSTDAPI InitPropVariantFromStringAsVector(
  [in]  PCWSTR      psz,
  [out] PROPVARIANT *ppropvar
);

Parameter

[in] psz

Typ: PCWSTR

Zeiger auf einen Puffer, der die Unicode-Quellzeichenfolge enthält.

[out] ppropvar

Typ: PROPVARIANT*

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

Rückgabewert

Typ: HRESULT

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

Hinweise

Erstellt eine VT_VECTOR | VT_LPWSTR propvariant. Die Quellzeichenfolge wird als Semikolonliste von Werten analysiert. Die Zeichenfolge "a; B; c" erstellt einen Vektor mit drei Werten. Führende und nachfolgende Leerzeichen werden entfernt, und leere Werte werden weggelassen.

Wenn pszNULL ist oder keine Werte enthält, wird die PROPVARIANT-Struktur als VT_EMPTY initialisiert.

Beispiele

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

PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromStringAsVector(L"a; b; c", &propvar);

if (SUCCEEDED(hr))
{
    // propvar now has type VT_VECTOR | VT_LPWSTR and contains {"a", "b", "c"}.
    PropVariantClear(&propvar);
}

Anforderungen

Weitere Informationen

InitPropVariantFromString

InitPropVariantFromStringVector

InitVariantFromStringArray

PropVariantToStringVector