Fungsi PropVariantToBooleanVectorAlloc (propvarutil.h)

Mengekstrak data dari struktur PROPVARIANT ke vektor Boolean yang baru dialokasikan.

Sintaks

PSSTDAPI PropVariantToBooleanVectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] BOOL           **pprgf,
  [out] ULONG          *pcElem
);

Parameter

[in] propvar

Jenis: REFPROPVARIANT

Referensi ke struktur PROPVARIANT sumber.

[out] pprgf

Jenis: BOOL**

Ketika fungsi ini kembali, berisi penunjuk ke vektor nilai Boolean yang diekstrak dari struktur PROPVARIANT sumber.

[out] pcElem

Jenis: ULONG*

Ketika fungsi ini kembali, berisi jumlah elemen Boolean yang diekstrak dari struktur PROPVARIANT sumber.

Nilai kembali

Jenis: HRESULT

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya.
E_INVALIDARG	PROPVARIANT bukan tipe yang sesuai.

Keterangan

Fungsi pembantu ini digunakan di tempat-tempat di mana aplikasi panggilan mengharapkan PROPVARIANT untuk menyimpan nilai vektor Boolean.

Jika PROPVARIANT sumber memiliki jenis VT_VECTOR | VT_BOOL atau VT_ARRAY | VT_BOOL, fungsi ini mengekstrak vektor nilai Boolean ke dalam vektor nilai BOOL yang baru dialokasikan. Aplikasi panggilan bertanggung jawab untuk menggunakan CoTaskMemFree untuk merilis vektor yang ditunjukkan oleh pprgf ketika tidak lagi diperlukan.

Contoh

Contoh berikut, untuk disertakan sebagai bagian dari program yang lebih besar, menunjukkan cara menggunakan PropVariantToBooleanVectorAlloc untuk mengakses nilai vektor Boolean dalam PROPVARIANT.

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. The application is 
// expecting propvar to contain a vector of Boolean values.
BOOL *prgFlags;
ULONG cFlags;
HRESULT hr = PropVariantToBooleanVectorAlloc(propvar, &prgFlags, &cFlags);

if (SUCCEEDED(hr))
{
     // The prgFlags variable now points to a vector that contains a count
     // of cFlags flags.
     CoTaskMemFree(prgFlags);
}

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

InitPropVariantFromBooleanVector

IsPropVariantVector

PropVariantGetBooleanElem

PropVariantToBooleanVector