Fungsi VariantToDoubleArrayAlloc (propvarutil.h)

Mengalokasikan array nilai DOUBLE lalu mengekstrak data dari struktur VARIAN ke dalam array tersebut.

Sintaks

PSSTDAPI VariantToDoubleArrayAlloc(
  [in]  REFVARIANT var,
  [out] DOUBLE     **pprgn,
  [out] ULONG      *pcElem
);

Parameter

[in] var

Jenis: REFVARIANT

Referensi ke struktur VARIAN sumber.

[out] pprgn

Jenis: DOUBLE**

Ketika fungsi ini kembali, berisi penunjuk ke array nilai DOUBLE 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.

Nilai kembali

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 DOUBLE .

Jika VARIAN sumber berjenis VT_ARRAY | VT_R8, fungsi ini mengekstrak array nilai DOUBLE ke dalam array yang baru dialokasikan. Aplikasi panggilan bertanggung jawab untuk menggunakan CoTaskMemFree untuk merilis array yang ditujukkan oleh pprgn ketika tidak lagi diperlukan.

Contoh

Contoh berikut, untuk disertakan sebagai bagian dari program yang lebih besar, menunjukkan cara menggunakan VariantToDoubleArrayAlloc untuk mengakses nilai array DOUBLE dalam VARIAN.

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

HRESULT hr = VariantToDoubleArrayAlloc(var, &prgDoubles, &cElems);

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

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

InitVariantFromDoubleArray

PropVariantChangeType

PropVariantToDoubleVectorAlloc

VariantToDoubleArray