MMCFreeNotifyHandle 函式 (mmc.h)
MMCFreeNotifyHandle 函式是由嵌入式管理單元呼叫，以釋放傳送至 MMC 嵌入式管理單元之 MMCN_PROPERTY_CHANGE 通知訊息的句柄，以響應屬性表所進行的 MMCPropertyChangeNotify 呼叫。
語法
HRESULT MMCFreeNotifyHandle(
[in] LONG_PTR lNotifyHandle
);
參數
[in] lNotifyHandle
值，指定 控制台在IExtendPropertySheet2：：CreatePropertyPages 呼叫期間所提供的句柄。
傳回值
這個回呼函式可以傳回其中一個值。
備註
通知的句柄會透過 呼叫 IExtendPropertySheet2：：CreatePropertyPages 方法傳遞至嵌入式管理單元。 如果嵌入式管理單元傳回成功程式代碼 (S_OK，S_FALSE) 此方法，則嵌入式管理單元必須呼叫 MMCFreeNotifyHandle。 如果嵌入式管理單元傳回錯誤碼，MMC 會立即釋放句柄。
嵌入式管理單元可以隨時釋放句柄，因為 MMC 在提供給嵌入式管理單元之後不會使用句柄。 嵌入式管理單元只能在釋放 MMCPropertyChangeNotify 呼叫後呼叫 MMCFreeNotifyHandle 一次，而且它不得使用 MMCPropertyChangeNotify 呼叫中的句柄。
請注意，如果呼叫嵌入式管理單元的 IExtendPropertySheet2：：CreatePropertyPages 方法，則只能呼叫 MMCFreeNotifyHandle。 如果嵌入式管理單元使用 IPropertySheetCallback 來新增屬性頁，然後呼叫 IPropertySheetProvider：：AddPrimaryPages 與 NULL 第一個參數，MMC 將不會呼叫 IExtendPropertySheet2：：CreatePropertyPages。 以這種方式呼叫 AddPrimaryPages 會通知 MMC 已新增頁面，因此不需要呼叫嵌入式管理單元的 IExtendPropertySheet2：：CreatePropertyPages 方法。 如需詳細資訊，請參閱 新增精靈頁面：實作詳細數據。
下列清單包含案例，說明嵌入式管理單元可以呼叫 MMCFreeNotifyHandle 的情況：
- 在 IExtendPropertySheet2：：CreatePropertyPages 中，嵌入式管理單元不會新增任何屬性頁。 如果 CreatePropertyPages 未傳回錯誤結果，嵌入式管理單元可以在傳回之前呼叫 MMCFreeNotifyHandle。 否則，MMC 會釋放句柄。
- 在 IExtendPropertySheet2：：CreatePropertyPages 中，嵌入式管理單元會新增屬性頁，但不會將句柄傳遞至頁面。 同樣地，如果 CreatePropertyPages 未傳回錯誤結果，嵌入式管理單元可以在傳回之前呼叫 MMCFreeNotifyHandle。
- 在 IExtendPropertySheet2：：CreatePropertyPages 中，嵌入式管理單元會新增屬性頁，並將句柄傳遞至頁面。 不過，屬性頁不會呼叫 MMCPropertyChangeNotify。 在此情況下，嵌入式管理單元可以在屬性頁的解構函式中呼叫 MMCFreeNotifyHandle，或在傳回 (之前呼叫 MMCFreeNotifyHandle ，而不會從 CreatePropertyPages 傳回錯誤結果) 。
- 在 IExtendPropertySheet2：：CreatePropertyPages 中，嵌入式管理單元會新增屬性頁，並將句柄傳遞至頁面。 屬性頁會呼叫 MMCPropertyChangeNotify。 在此情況下，嵌入式管理單元應該在屬性頁的解構函式中呼叫 MMCFreeNotifyHandle 。 請注意，不建議在嵌入式管理單元的MMCN_PROPERTY_CHANGE通知處理程式中呼叫 MMCFreeNotifyHandle，因為多個頁面可能會傳送通知，或者相同的頁面可能會在每次使用者按兩下 [套用] 按鈕) 時傳送多個 (通知。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | mmc.h |