Fungsi InitVariantFromDispatch (propvarutil.h)

Menginisialisasi struktur VARIAN berdasarkan instans objek IDispatch .

Sintaks

HRESULT InitVariantFromDispatch(
  [in]  IDispatch *pdisp,
  [out] VARIANT   *pvar
);

Parameter

[in] pdisp

Jenis: IDispatch*

Arahkan ke sumber IDispatch.

[out] pvar

Jenis: VARIAN*

Ketika fungsi ini kembali, berisi struktur VARIAN yang diinisialisasi.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Membuat varian VT_DISPATCH .

Ini adalah fungsi sebaris, dengan kode sumbernya disediakan di header . Ini tidak termasuk dalam file .dll atau .lib.

Contoh

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

// IDispatch *pDispatch;
// Assume variable pDispatch is initialized and valid.
VARIANT var;

HRESULT hr = InitVariantFromDispatch(pDispatch, &var);

if (SUCCEEDED(hr))
{
    // var now is valid and has type VT_DISPATCH.
    VariantClear(&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