Fungsi MMCPropPageCallback (mmc.h)

Fungsi MMCPropPageCallback hanya diperlukan oleh snap-in berbasis Microsoft Foundation Classes (MFC). Fungsi ini mengatur status modul yang benar selama pembuatan halaman.

Sintaks

HRESULT MMCPropPageCallback(
  void *vpsp
);

Parameter

vpsp

Penunjuk ke struktur Microsoft Windows PROPSHEETPAGE . Ketahuilah bahwa secara default, MFC menginstal panggilan baliknya sendiri di anggota struktur pfnCallback .

Menampilkan nilai

Fungsi panggilan balik ini dapat mengembalikan salah satu nilai ini.

Keterangan

Fungsi ini tidak boleh dipanggil oleh snap-in yang secara statis menautkan pustaka MFC. Panggilan ke fungsi ini dengan snap-in seperti itu tidak akan ditautkan dengan benar.

Untuk setiap halaman yang berasal dari CPropertyPage, panggil MMCPropageCallback dengan penunjuk ke panggilan balik halaman, dengan mengikuti panduan berikut:

  • Semua halaman untuk lembar properti tertentu harus menggunakan penunjuk panggilan balik yang sama.
  • Jika Anda mengganti panggilan balik MFC dengan panggilan balik Anda sendiri, panggilan balik Anda harus memanggil panggilan balik MFC.
  • Anda harus memanggil fungsi ini dengan setiap kelas turunan CPropertyPage .
MFC harus memiliki set status modul yang benar dari fungsi yang diekspor atau antarmuka COM. Ini termasuk panggilan yang dilakukan dari sistem operasi ke modul. Untuk fungsi yang diekspor atau antarmuka COM, ini dilakukan dengan menambahkan makro AFX_MANAGE_STATE di awal semua fungsi yang diekspor dalam DLL snap-in yang secara dinamis menautkan ke MFC. Ini dilakukan dengan menambahkan baris kode berikut ke awal fungsi yang diekspor dari snap-in:
AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

Untuk panggilan sistem operasi, MFC melakukan ini secara otomatis. Karena lembar properti MMC bukan MFC CPropertySheet, panggilan sistem operasi karena panggilan balik berada dalam status modul yang salah. Akibatnya, Anda perlu memastikan bahwa status modul diatur dengan benar selama pembuatan halaman. Ini adalah tujuan dari MMCPropageCallback. Setelah status modul ditetapkan, satu-satunya panggilan AFX_MANAGE_STATE yang perlu dilakukan adalah panggilan yang diekspos oleh antarmuka COM yang diimplementasikan oleh snap-in (misalnya IExtendPropertySheet2::CreatePropertyPages). Untuk menentukan apakah aplikasi memiliki status modul yang benar, lihat CWinApp dan catat nama aplikasi.

Persyaratan

   
Klien minimum yang didukung Windows Vista
Server minimum yang didukung Windows Server 2008
Target Platform Windows
Header mmc.h

Lihat juga

PROPSHEETPAGE