Fungsi MMCFreeNotifyHandle (mmc.h)
Fungsi MMCFreeNotifyHandle dipanggil oleh snap-in untuk membebaskan handel ke pesan pemberitahuan MMCN_PROPERTY_CHANGE yang dikirim ke snap-in oleh MMC sebagai respons terhadap panggilan MMCPropertyChangeNotify yang dilakukan oleh lembar properti.
Sintaks
HRESULT MMCFreeNotifyHandle(
[in] LONG_PTR lNotifyHandle
);
Parameter
[in] lNotifyHandle
Nilai yang menentukan handel yang disediakan oleh konsol selama panggilan IExtendPropertySheet2::CreatePropertyPages .
Nilai kembali
Fungsi panggilan balik ini dapat mengembalikan salah satu nilai ini.
Keterangan
Handel ke pemberitahuan diteruskan ke snap-in melalui panggilan ke metode IExtendPropertySheet2::CreatePropertyPages . Jika snap-in mengembalikan kode sukses (S_OK, S_FALSE) dari metode ini, snap-in harus memanggil MMCFreeNotifyHandle. Jika snap-in mengembalikan kode kesalahan, maka MMC segera membebaskan handel.
Snap-in dapat membebaskan handel kapan saja, karena MMC tidak menggunakan handel setelah diberikan ke snap-in. Snap-in hanya boleh memanggil MMCFreeNotifyHandle sekali dan tidak boleh menggunakan handel dalam panggilan MMCPropertyChangeNotify setelah dikosongkan.
Ketahuilah bahwa snap-in hanya harus memanggil MMCFreeNotifyHandle jika metode IExtendPropertySheet2::CreatePropertyPages dipanggil. MMC tidak akan memanggil IExtendPropertySheet2::CreatePropertyPages jika snap-in menggunakan IPropertySheetCallback untuk menambahkan halaman properti lalu memanggil IPropertySheetProvider::AddPrimaryPages dengan parameter pertama NULL . Memanggil AddPrimaryPages dengan cara ini menginformasikan MMC bahwa halaman telah ditambahkan, sehingga tidak diharuskan untuk memanggil metode IExtendPropertySheet2::CreatePropertyPages snap-in. Untuk informasi selengkapnya, lihat Menambahkan Halaman Wizard: Detail Implementasi.
Daftar berikut berisi skenario yang menggambarkan situasi di mana snap-in dapat memanggil MMCFreeNotifyHandle:
- Di IExtendPropertySheet2::CreatePropertyPages, snap-in tidak menambahkan halaman properti apa pun. Jika CreatePropertyPages tidak mengembalikan hasil kesalahan, snap-in dapat memanggil MMCFreeNotifyHandle sebelum kembali. Jika tidak, MMC akan membebaskan handel.
- Di IExtendPropertySheet2::CreatePropertyPages, snap-in menambahkan halaman properti, tetapi tidak meneruskan handel ke halaman. Sekali lagi, jika CreatePropertyPages tidak mengembalikan hasil kesalahan, snap-in dapat memanggil MMCFreeNotifyHandle sebelum kembali.
- Di IExtendPropertySheet2::CreatePropertyPages, snap-in menambahkan halaman properti dan juga meneruskan handel ke halaman. Namun, halaman properti tidak memanggil MMCPropertyChangeNotify. Dalam hal ini, snap-in dapat memanggil MMCFreeNotifyHandle baik di destruktor halaman properti atau sebelum mengembalikan (tanpa hasil kesalahan) dari CreatePropertyPages.
- Di IExtendPropertySheet2::CreatePropertyPages, snap-in menambahkan halaman properti dan juga meneruskan handel ke halaman. Halaman properti memanggil MMCPropertyChangeNotify. Dalam hal ini, snap-in harus memanggil MMCFreeNotifyHandle di destruktor halaman properti. Ketahuilah bahwa memanggil MMCFreeNotifyHandle di handler pemberitahuan MMCN_PROPERTY_CHANGE snap-in tidak disarankan, karena beberapa halaman dapat mengirim pemberitahuan, atau halaman yang sama dapat mengirim beberapa pemberitahuan (satu setiap kali pengguna mengklik tombol Terapkan ).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | mmc.h |