IPart::UnregisterControlChangeCallback-Methode (devicetopology.h)

Die UnregisterControlChangeCallback-Methode entfernt die Registrierung einer IControlChangeNotify-Schnittstelle , die der Client zuvor durch einen Aufruf der IPart::RegisterControlChangeCallback-Methode registriert hat.

Syntax

HRESULT UnregisterControlChangeCallback(
  [in] IControlChangeNotify *pNotify
);

Parameter

[in] pNotify

Zeiger auf die IControlChangeNotify-Schnittstelle , deren Registrierung gelöscht werden soll. Der Client hat denselben Schnittstellenzeiger an das Part-Objekt in einem vorherigen Aufruf der IPart::RegisterControlChangeCallback-Methode übergeben. Wenn die UnregisterControlChangeCallback-Methode erfolgreich ist, ruft sie die Release-Methode auf der IControlChangeNotify-Schnittstelle des Clients auf.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.

Hinweise

Bevor der Client seinen endgültigen Verweis auf die IControlChangeNotify-Schnittstelle freigibt, sollte er UnregisterControlChangeCallback aufrufen, um die Registrierung der Schnittstelle aufzuheben. Andernfalls werden die Ressourcen der Objekte IControlChangeNotify und IPart von der Anwendung verloren. Beachten Sie, dass die IPart::RegisterControlChangeCallback-Methode die IControlChangeNotify::AddRef-Methode des Clients und UnregisterControlChangeCallback die IControlChangeNotify::Release-Methode aufruft. Wenn der Client fehlert, indem er seinen Verweis auf die IControlChangeNotify-Schnittstelle vor dem Aufruf von UnregisterControlChangeCallback freigibt, gibt das IPart-Objekt nie seinen Verweis auf die IControlChangeNotify-Schnittstelle frei. Beispielsweise kann eine schlecht gestaltete IControlChangeNotify-ImplementierungUnregisterControlChangeCallback vom Destruktor für das IControlChangeNotify-Objekt aufrufen. In diesem Fall ruft der Client UnregisterControlChangeCallback erst auf, wenn das IPart-Objekt seinen Verweis auf die IControlChangeNotify-Schnittstelle freigibt, und das IPart-Objekt gibt seinen Verweis auf die IControlChangeNotify-Schnittstelle erst frei, wenn der Client UnregisterControlChangeCallback aufruft. Weitere Informationen zu den Methoden AddRef und Release finden Sie in der Windows SDK-Dokumentation zur IUnknown-Schnittstelle .

Anforderungen

Weitere Informationen

IControlChangeNotify-Schnittstelle

IPart-Schnittstelle

IPart::RegisterControlChangeCallback