Fungsi VariantToBooleanArrayAlloc (propvarutil.h)

Mengalokasikan array nilai BOOL kemudian mengekstrak data dari struktur VARIAN ke dalam array tersebut.

Sintaks

PSSTDAPI VariantToBooleanArrayAlloc(
  [in]  REFVARIANT var,
  [out] BOOL       **pprgf,
  [out] ULONG      *pcElem
);

Parameter

[in] var

Jenis: REFVARIANT

Referensi ke struktur VARIAN sumber.

[out] pprgf

Jenis: BOOL**

Ketika fungsi ini kembali, berisi penunjuk ke array nilai BOOL yang diekstrak dari struktur VARIAN sumber.

[out] pcElem

Jenis: ULONG*

Ketika fungsi ini kembali, berisi penunjuk ke hitungan elemen yang diekstrak dari struktur VARIAN sumber.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Fungsi pembantu ini digunakan ketika aplikasi panggilan mengharapkan VARIAN untuk menyimpan array nilai BOOL .

Jika VARIAN sumber berjenis VT_ARRAY | VT_BOOL, fungsi ini mengekstrak array nilai BOOL ke dalam array yang baru dialokasikan. Aplikasi panggilan bertanggung jawab untuk menggunakan CoTaskMemFree untuk merilis array yang diacu oleh pprgf ketika tidak lagi diperlukan.

Contoh

Contoh berikut, untuk disertakan sebagai bagian dari program yang lebih besar, menunjukkan cara menggunakan VariantToBooleanArrayAlloc untuk mengakses array nilai BOOL yang disimpan dalam struktur VARIAN .

// VARIANT var;
// Assume variable var is initialized and valid. 
// The application expects var to contain an array of BOOL values.
BOOL *prgFlags;
ULONG cElems;

HRESULT hr = VariantToBooleanArrayAlloc(var, &prgFlags, &cElems);

if (SUCCEEDED(hr))
{
     // prgFlags now points to a vector of cElems BOOLs.
     CoTaskMemFree(prgFlags);
}

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

InitVariantFromBooleanArray

PropVariantToBooleanVector

VariantToBooleanArray