Fungsi OleCreateDefaultHandler (ole2.h)
Membuat instans baru dari handler penyematan default. Instans ini diinisialisasi sehingga membuat server lokal ketika objek yang disematkan memasuki status berjalan.
Sintaks
HRESULT OleCreateDefaultHandler(
[in] REFCLSID clsid,
[in] LPUNKNOWN pUnkOuter,
[in] REFIID riid,
[out] LPVOID *lplpObj
);
Parameter
[in] clsid
CLSID mengidentifikasi server OLE yang akan dimuat ketika objek yang disematkan memasuki status berjalan.
[in] pUnkOuter
Arahkan ke antarmuka IUnknown pengontrol jika handler akan diagregasi; NULL jika tidak akan diagregasi.
[in] riid
Referensi ke pengidentifikasi antarmuka, biasanya IID_IOleObject, di mana pemanggil akan berkomunikasi dengan handler.
[out] lplpObj
Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, *ppvObj berisi penunjuk antarmuka yang diminta pada handler yang baru dibuat.
Nilai kembali
Fungsi ini mengembalikan NOERROR pada keberhasilan dan mendukung nilai pengembalian standar E_OUTOFMEMORY.
Keterangan
OleCreateDefaultHandler membuat instans baru dari handler penyematan default, yang diinisialisasi sehingga membuat server lokal yang diidentifikasi oleh parameter clsid ketika objek yang disematkan memasuki status berjalan. Jika Anda menulis handler dan ingin menggunakan layanan handler default, panggil OleCreateDefaultHandler. OLE juga memanggilnya secara internal ketika CLSID yang ditentukan dalam panggilan pembuatan objek tidak terdaftar.
Jika kelas yang diberikan tidak memiliki handler khusus, panggilan ke OleCreateDefaultHandler menghasilkan hasil yang sama dengan panggilan ke fungsi CoCreateInstance dengan parameter konteks kelas yang diberi nilai CLSCTX_INPROC_HANDLER.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | ole2.h |
| Pustaka | Ole32.lib |
| DLL | Ole32.dll |