MMCFreeNotifyHandle-Funktion (mmc.h)
Die MMCFreeNotifyHandle-Funktion wird von einem Snap-In aufgerufen, um das Handle für eine MMCN_PROPERTY_CHANGE Benachrichtigung freizugeben, die mmc als Reaktion auf einen MMCPropertyChangeNotify-Aufruf von einem Eigenschaftenblatt an das Snap-In gesendet hat.
Syntax
HRESULT MMCFreeNotifyHandle(
[in] LONG_PTR lNotifyHandle
);
Parameter
[in] lNotifyHandle
Ein -Wert, der ein Handle angibt, das von der Konsole während eines IExtendPropertySheet2::CreatePropertyPages-Aufrufs bereitgestellt wird.
Rückgabewert
Diese Rückruffunktion kann einen dieser Werte zurückgeben.
Hinweise
Das Handle für die Benachrichtigung wird über einen Aufruf der IExtendPropertySheet2::CreatePropertyPages-Methode an das Snap-In übergeben. Wenn das Snap-In einen Erfolgscode (S_OK, S_FALSE) aus dieser Methode zurückgibt, muss das Snap-In MMCFreeNotifyHandle aufrufen. Wenn das Snap-In einen Fehlercode zurückgibt, gibt MMC das Handle sofort frei.
Das Snap-In kann den Ziehpunkt jederzeit freigeben, da MMC das Handle nicht verwendet, nachdem es dem Snap-In übergeben wurde. Das Snap-In darf MMCFreeNotifyHandle nur einmal aufrufen und darf das Handle in einem MMCPropertyChangeNotify-Aufruf nicht verwenden, nachdem es freigegeben wurde.
Beachten Sie, dass das Snap-In nur MMCFreeNotifyHandle aufrufen darf, wenn die IExtendPropertySheet2::CreatePropertyPages-Methode aufgerufen wird. MMC ruft IExtendPropertySheet2::CreatePropertyPages nicht auf, wenn das Snap-In IPropertySheetCallback verwendet, um Eigenschaftenseiten hinzuzufügen, und dann IPropertySheetProvider::AddPrimaryPages mit einem ersten NULL-Parameter aufruft. Wenn Sie AddPrimaryPages auf diese Weise aufrufen, wird MMC informiert, dass die Seiten bereits hinzugefügt wurden. Daher ist es nicht erforderlich, die IExtendPropertySheet2::CreatePropertyPages-Methode des Snap-Ins aufzurufen. Weitere Informationen finden Sie unter Hinzufügen von Assistentenseiten: Implementierungsdetails.
Die folgende Liste enthält Szenarien, die Situationen veranschaulichen, in denen das Snap-In MMCFreeNotifyHandle aufrufen kann:
- In IExtendPropertySheet2::CreatePropertyPages fügt das Snap-In keine Eigenschaftenseiten hinzu. Wenn CreatePropertyPages kein Fehlerergebnis zurückgibt, kann das Snap-In MMCFreeNotifyHandle aufrufen, bevor es zurückgegeben wird. Andernfalls gibt MMC den Handle frei.
- In IExtendPropertySheet2::CreatePropertyPages fügt das Snap-In Eigenschaftenseiten hinzu, übergibt das Handle jedoch nicht an die Seiten. Wenn CreatePropertyPages kein Fehlerergebnis zurückgibt, kann das Snap-In MMCFreeNotifyHandle vor der Rückgabe aufrufen.
- In IExtendPropertySheet2::CreatePropertyPages fügt das Snap-In Eigenschaftenseiten hinzu und übergibt auch das Handle an die Seiten. Die Eigenschaftenseiten rufen jedoch nicht MMCPropertyChangeNotify auf. In diesem Fall kann das Snap-In MMCFreeNotifyHandle entweder im Destruktor der Eigenschaftenseiten oder vor der Rückgabe (ohne Fehlerergebnis) von CreatePropertyPages aufrufen.
- In IExtendPropertySheet2::CreatePropertyPages fügt das Snap-In Eigenschaftenseiten hinzu und übergibt auch das Handle an die Seiten. Die Eigenschaftenseiten rufen MMCPropertyChangeNotify auf. In diesem Fall sollte das Snap-In MMCFreeNotifyHandle im Destruktor der Eigenschaftenseiten aufrufen. Beachten Sie, dass der Aufruf von MMCFreeNotifyHandle im MMCN_PROPERTY_CHANGE-Benachrichtigungshandler des Snap-Ins nicht empfohlen wird, da mehrere Seiten Benachrichtigungen senden oder dieselbe Seite mehrere Benachrichtigungen senden kann (eine, wenn der Benutzer auf die Schaltfläche Anwenden klickt).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | mmc.h |