Share via

Metode IOleControlSite::GetExtendedControl (ocidl.h)

  • Artikel

Mengambil pointer IDispatch ke kontrol yang diperluas yang digunakan kontainer untuk membungkus kontrol nyata.

Sintaks

HRESULT GetExtendedControl(
  [out] IDispatch **ppDisp
);

Parameter

[out] ppDisp

Penunjuk ke variabel penunjuk IDispatch yang menerima penunjuk antarmuka ke kontrol yang diperluas. Jika terjadi kesalahan, implementasi harus mengatur *ppDisp ke NULL. Jika berhasil, penelepon bertanggung jawab untuk memanggil Rilis ketika *ppDisp tidak lagi diperlukan.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil diselesaikan.
E_NOTIMPL
 Kontainer tidak menerapkan kontrol yang diperluas.
E_POINTER
 Alamat dalam ppDisp atau *ppDisp tidak valid. Misalnya, mungkin NULL.

Keterangan

Metode ini memberikan akses kontrol nyata ke properti dan metode apa pun yang dipertahankan kontainer dalam kontrol yang diperluas. Properti dan metode ini jika tidak dapat diakses oleh kontrol.

Catatan untuk Penelepon

Pointer yang dikembalikan adalah tanggung jawab pemanggil, yang harus melepaskannya ketika tidak lagi diperlukan.

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 ocidl.h

Lihat juga

IOleControlSite