Fungsi PropVariantToFileTimeVectorAlloc (propvarutil.h)

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

Sintaks

PSSTDAPI PropVariantToFileTimeVectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] FILETIME       **pprgft,
  [out] ULONG          *pcElem
);

Parameter

[in] propvar

Jenis: REFPROPVARIANT

Referensi ke struktur PROPVARIANT sumber.

[out] pprgft

Jenis: FILETIME**

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

[out] pcElem

Jenis: ULONG*

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

Nilai kembali

Jenis: HRESULT

Mengembalikan salah satu nilai berikut.

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

Jika PROPVARIANT sumber memiliki jenis VT_VECTOR | VT_FILETIME, fungsi ini mengekstrak vektor nilai FILETIMEs ke dalam vektor nilai FILETIME yang baru dialokasikan. Aplikasi panggilan bertanggung jawab untuk menggunakan CoTaskMemFree untuk merilis vektor yang ditunjukkan oleh pprgft ketika tidak lagi diperlukan.

FILETIMES output akan menggunakan zona waktu yang sama dengan FILETIMES sumber.

Contoh

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

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. 
// The application is expecting propvar to contain a vector of FILETIME values.
BOOL *prgTimes;
ULONG cTimes;
HRESULT hr = PropVariantToBooleanVectorAlloc(propvar, &prgTimes, &cTimes);
if (SUCCEEDED(hr))
{
     // prgTimes now points to a vector of cTimes file times.
     CoTaskMemFree(prgTimes);
}

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

InitPropVariantFromFileTimeVector

PropVariantToFileTime

PropVariantToFileTimeVector