Fungsi InitPropVariantFromStringAsVector (propvarutil.h)

Menginisialisasi struktur PROPVARIANT dari string tertentu. String diurai sebagai daftar yang dibatasi titik koma (misalnya: "A; B; C").

Sintaks

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

Parameter

[in] psz

Jenis: PCWSTR

Penunjuk ke buffer yang berisi string Unicode sumber.

[out] ppropvar

Jenis: PROPVARIANT*

Ketika fungsi ini kembali, berisi struktur PROPVARIANT yang diinisialisasi.

Menampilkan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Membuat VT_VECTOR | VT_LPWSTR propvariant. Ini mengurai string sumber sebagai daftar titik koma nilai. String "a; B; c" membuat vektor dengan tiga nilai. Spasi kosong di depan dan di belakang dihapus, dan nilai kosong dihilangkan.

Jika pszNULL atau tidak berisi nilai, struktur PROPVARIANT diinisialisasi sebagai VT_EMPTY.

Contoh

Contoh berikut, untuk disertakan sebagai bagian dari program yang lebih besar, menunjukkan cara menggunakan 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);
}

Persyaratan

Klien minimum yang didukung	Windows XP dengan SP2, Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	propvarutil.h
Pustaka	Propsys.lib
DLL	Propsys.dll (versi 6.0 atau yang lebih baru)
Redistribusi	Windows Desktop Search (WDS) 3.0

Lihat juga

InitPropVariantFromString

InitPropVariantFromStringVector

InitVariantFromStringArray

PropVariantToStringVector