Fungsi InitPropVariantFromBoolean (propvarutil.h)

Menginisialisasi struktur PROPVARIANT tertentu sebagai VT_BOOL menggunakan nilai Boolean tertentu.

Sintaks

HRESULT InitPropVariantFromBoolean(
  [in]  BOOL        fVal,
  [out] PROPVARIANT *ppropvar
);

Parameter

[in] fVal

Jenis: BOOL

Nilai BOOL sumber.

[out] ppropvar

Jenis: PROPVARIANT*

Ketika fungsi ini kembali, berisi struktur PROPVARIANT yang diinisialisasi.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Ini adalah fungsi sebaris, dengan kode sumber yang disediakan di header . Ini tidak termasuk dalam file .dll atau .lib apa pun.

Perhatikan bahwa anggota boolVal yang secara khusus diinisialisasi oleh fungsi ini berjenis VARIANT_BOOL dan karenanya dapat memiliki nilai VARIANT_TRUE atau VARIANT_FALSE. Saat bekerja dengan anggota struktur ini secara langsung, gunakan konstanta ini alih-alih TRUE atau FALSE karena VARIANT_TRUE tidak sama dengan TRUE dan sizeof(VARIANT_TRUE) tidak sama dengan sizeof(TRUE).

Contoh

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

PROPVARIANT propvar;

HRESULT hr = InitPropVariantFromBoolean(TRUE, &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_BOOL.
 
    PropVariantClear(&propvar);
}

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
Redistribusi	Windows Desktop Search (WDS) 3.0

Lihat juga

InitPropVariantFromBooleanVector

InitVariantFromBoolean

PropVariantToBoolean