Funzione InitPropVariantFromStringAsVector (propvarutil.h)
Inizializza una struttura PROPVARIANT da una stringa specificata. La stringa viene analizzata come elenco delimitato da punti e virgola (ad esempio: "A; B; C").
Sintassi
PSSTDAPI InitPropVariantFromStringAsVector(
[in] PCWSTR psz,
[out] PROPVARIANT *ppropvar
);
Parametri
[in] psz
Tipo: PCWSTR
Puntatore a un buffer contenente la stringa Unicode di origine.
[out] ppropvar
Tipo: PROPVARIANT*
Quando termina, questa funzione contiene la struttura PROPVARIANT inizializzata.
Valore restituito
Tipo: HRESULT
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Crea un VT_VECTOR | VT_LPWSTR propvariante. Analizza la stringa di origine come elenco di valori con punto e virgola. Stringa "a; B; c" crea un vettore con tre valori. Gli spazi vuoti iniziali e finali vengono rimossi e i valori vuoti vengono omessi.
Se psz è NULL o non contiene valori, la struttura PROPVARIANT viene inizializzata come VT_EMPTY.
Esempio
Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare InitPropVariantFromStringAsVector.
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);
}
Requisiti
| Client minimo supportato | Windows XP con SP2, Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 con SP1 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | propvarutil.h |
| Libreria | Propsys.lib |
| DLL | Propsys.dll (versione 6.0 o successiva) |
| Componente ridistribuibile | Windows Desktop Search (WDS) 3.0 |