Fungsi InitVariantFromStringArray (propvarutil.h)

Menginisialisasi struktur VARIAN dengan array string.

Sintaks

PSSTDAPI InitVariantFromStringArray(
  [in]  PCWSTR  *prgsz,
  [in]  ULONG   cElems,
  [out] VARIANT *pvar
);

Parameter

[in] prgsz

Jenis: PCWSTR*

Penunjuk ke array string.

[in] cElems

Jenis: ULONG

Jumlah elemen dalam array yang ditujukkan oleh prgsz.

[out] pvar

Jenis: VARIAN*

Ketika fungsi ini kembali, berisi struktur VARIAN yang diinisialisasi.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Membuat VT_ARRAY | varian VT_BSTR.

Contoh

Contoh berikut, untuk disertakan sebagai bagian dari program yang lebih besar, menunjukkan cara menggunakan InitVariantFromStringArray.

PCWSTR rgStrings[] = {"dog", "cat"};
VARIANT var;

HRESULT hr = InitVariantFromStringArray(rgStrings, ARRAYSIZE(rgStrings), &var);

if (SUCCEEDED(hr))
{
    // var now is valid and has type VT_ARRAY | VT_BSTR.
    VariantClear(&var);
}

Persyaratan

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

InitVariantFromString

VariantToStringArray