Winapi.Mtx.CreateSharedPropertyGroup
Delphi
function CreateSharedPropertyGroup(const Name: WideString): ISharedPropertyGroup;
C++
extern DELPHI_PACKAGE _di_ISharedPropertyGroup __fastcall CreateSharedPropertyGroup(const System::WideString Name);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Winapi.Mtx.pas Winapi.Mtx.hpp |
Winapi.Mtx | Winapi.Mtx |
Beschreibung
Gibt das Interface für ein SharedPropertyGroup-Objekt zurück, das MTS-Objekten in einem Server-Prozess das gemeinsame Nutzen von Statusinformationen ermöglicht.
CreateSharedPropertyGroup gibt ein Interface zu einer neuen gemeinsamen Eigenschaftsgruppe zurück. Ist bereit eine Gruppe mit dem angegebenen Namen vorhanden, wird eine Verweis auf diese geliefert. Mit dieser Funktion können Sie gemeinsam nutzbare Eigenschaften einer Eigenschaftsgruppe erstellen und auf diese zugreifen.
CreateSharedPropertyGroup richtet ein SharedPropertyGroup-Objekt mit den Standardwerten LockSetGet für den Sperrmodus und Process für den Freigabemodus ein. LockSetGet sperrt eine Eigenschaft bei jedem Lese- oder Schreibzugriff auf eine gemeinsame Eigenschaft. Dadurch ist sichergestellt, dass der Zugriff nicht gleichzeitig durch mehrere Clients erfolgt. Die anderen Eigenschaften derselben Gruppe können jedoch von anderen Clients zur selben Zeit gelesen oder geschrieben werden. Der Process-Freigabemodus stellt sicher, dass die Eigenschaftsgruppe nicht zerstört wird, bevor der Prozess, in dem sie erzeugt wurde, beendet ist. (Objekte mit Referenzen auf eine Eigenschaftsgruppe müssen ihre Referenzen trotzdem mit Release freigeben.)
Um diese Standardwerte zu überschreiben, rufen Sie CreateSharedPropertyGroupManager auf und erstellen mit Hilfe des zurückgegebenen Interface eine Eigenschaftsgruppe.
ISharedPropertyGroup hat mehrere Methoden, um Statusinformationen in mehreren Objekten eines Server-Prozesses gemeinsam zu nutzen. Eine Liste dieser Methoden finden Sie unter ISharedPropertyGroup in der MTS-Dokumentation.
Gruppen für gemeinsam genutzte Eigenschaften schließen Namenskollisionen aus, weil für die gemeinsam genutzten Eigenschaften eindeutige Namespaces eingerichtet werden. Der Eigenschaftsmanager (Shared Property Manager) implementiert auch Sperren und Semaphoren, um die gemeinsam genutzten Eigenschaften vor gleichzeitigen Zugriffen zu schützen, die zu verlorenen Aktualisierungen und undefinierten Eigenschaften führen könnten.
Anmerkung: Nur Objekte, die im selben Prozess ausgeführt werden, können gemeinsame Eigenschaften verwenden. Wenn Instanzen von verschiedenen Komponenten Eigenschaften gemeinsam nutzen sollen, müssen diese Komponenten im selben MTS-Package installiert werden. Da die Möglichkeit besteht, dass Komponenten von einem Package in ein anderes verlagert werden, sollten Sie gemeinsam genutzte Eigenschaftsgruppen nur für Instanzen von Komponenten zulassen, die in derselben DLL definiert sind.