Fungsi PropVariantGetInt32Elem (propvarutil.h)

Artikel
03/15/2023

Mengekstrak satu elemen Int32 dari PROPVARIANT jenis VT_I4, VT_VECTOR | VT_I4, atau VT_ARRAY | VT_I4.

Sintaks

PSSTDAPI PropVariantGetInt32Elem(
  [in]  REFPROPVARIANT propvar,
  [in]  ULONG          iElem,
  [out] LONG           *pnVal
);

Parameter

[in] propvar

Jenis: REFPROPVARIANT

Referensi ke struktur PROPVARIANT sumber.

[in] iElem

Jenis: ULONG

Indeks vektor atau array; jika tidak, iElem harus 0.

[out] pnVal

Jenis: LONG*

Ketika fungsi ini, berisi nilai Int32 yang diekstrak.

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

Fungsi pembantu ini berfungsi untuk struktur PROPVARIANT dari jenis berikut:

VT_I4
VT_VECTTOR | VT_I4
VT_ARRAY | VT_I4

Jika PROPVARIANT sumber memiliki jenis VT_I4, iElem harus 0. Jika tidak, iElem harus kurang dari jumlah elemen dalam vektor atau array. Anda dapat menggunakan PropVariantGetElementCount untuk mendapatkan jumlah elemen dalam vektor atau array.

Contoh

Contoh berikut menggunakan PropVariantGetInt32Elem ini dengan pernyataan iterasi untuk mengakses nilai dalam struktur PROPVARIANT .

// PROPVARIANT propvar;
// assume propvar is initialized and valid

if ((propvar.vt & VT_TYPEMASK) == VT_I4)
{
    UINT cElem = PropVariantGetElementCount(propvar);
    HRESULT hr = <mark type="const">S_OK</mark>;

    for (UINT iElem = 0; SUCCEEDED(hr) && iElem < cElem; iElem ++)
    {
        LONG nValue;
        hr = PropVariantGetInt32Elem(propvar, iElem, &nValue);

        if (SUCCEEDED(hr))
        {
            // nValue is valid now
        }
    }
}

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

PropVariantGetElem

Share via