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
| 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 |