Freigeben über


MMCPropertyChangeNotify-Funktion (mmc.h)

Die MMCPropertyChangeNotify-Funktion ermöglicht es einem Snap-In-Eigenschaftenblatt, seine IComponent - oder IComponentData-Schnittstelle darüber zu benachrichtigen, dass sich die Eigenschaften eines Elements geändert haben.

Eigenschaftenblätter werden in einem anderen Thread als ihr IComponent- und IComponentData-Server ausgeführt. Wenn es sich also um einen COM-Schnittstellenzeiger handelt, muss er gemarshallt werden. Durch den asynchronen Aufruf dieser Funktion wird der IComponent oder die IComponentData benachrichtigt, die der Eigenschaftenseite zugeordnet ist, deren Eigenschaften sich geändert haben.

Syntax

HRESULT MMCPropertyChangeNotify(
  [in] LONG_PTR lNotifyHandle,
  [in] LPARAM   param
);

Parameter

[in] lNotifyHandle

Ein -Wert, der das Handle angibt, das zum Weiterleiten der Benachrichtigung an die entsprechende IComponent oder IComponentData verwendet wird.

[in] param

Benutzerdefiniert. Kann frei verwendet werden.

Rückgabewert

Diese Rückruffunktion kann einen dieser Werte zurückgeben.

Hinweise

Dies ist das Handle, das an IExtendPropertySheet2::CreatePropertyPages übergeben wird.

Ein Aufruf von MMCPropertyChangeNotify bewirkt, dass eine MMCN_PROPERTY_CHANGE Benachrichtigung an das Snap-In gesendet wird.

Der an MMCPropertyChangeNotify übergebeneParameterwert wird wiederum an das Snap-In als param-Argument an MMCN_PROPERTY_CHANGE weitergeleitet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile mmc.h

Weitere Informationen

IComponent

IExtendPropertySheet2

MMCFreeNotifyHandle