ISharedPropertyGroupManager::CreatePropertyGroup-Methode (comsvcs.h)

Artikel
08/22/2023

Erstellt eine neue freigegebene Eigenschaftengruppe. Wenn bereits eine Eigenschaftengruppe mit dem angegebenen Namen vorhanden ist, gibt CreatePropertyGroup einen Verweis auf die vorhandene Gruppe zurück.

Syntax

HRESULT CreatePropertyGroup(
  [in]      BSTR                 Name,
  [in, out] LONG                 *dwIsoMode,
  [in, out] LONG                 *dwRelMode,
  [out]     VARIANT_BOOL         *fExists,
  [out]     ISharedPropertyGroup **ppGroup
);

Parameter

[in] Name

Der Name der zu erstellenden freigegebenen Eigenschaftengruppe.

[in, out] dwIsoMode

Der Isolationsmodus für die Eigenschaften in der neuen freigegebenen Eigenschaftengruppe. Weitere Informationen finden Sie in der Tabelle der Konstanten in den Anmerkungen unten. Wenn der Wert des fExists-Parameters bei der Rückgabe von dieser Methode auf VARIANT_TRUE festgelegt ist, wird der Eingabewert ignoriert, und der in diesem Parameter zurückgegebene Wert ist der Isolationsmodus, der zugewiesen wurde, als die Eigenschaftengruppe erstellt wurde.

[in, out] dwRelMode

Der Releasemodus für die Eigenschaften in der neuen freigegebenen Eigenschaftengruppe. Weitere Informationen finden Sie in der Tabelle der Konstanten in den Anmerkungen unten. Wenn der Wert des fExists-Parameters bei der Rückgabe von dieser Methode auf VARIANT_TRUE festgelegt ist, wird der Eingabewert ignoriert, und der in diesem Parameter zurückgegebene Wert ist der Releasemodus, der zugewiesen wurde, als die Eigenschaftengruppe erstellt wurde.

[out] fExists

VARIANT_TRUE bei der Rückgabe von dieser Methode, wenn die im name-Parameter angegebene freigegebene Eigenschaftengruppe vor diesem Aufruf vorhanden war, und VARIANT_FALSE, ob die Eigenschaftengruppe durch diesen Aufruf erstellt wurde.

[out] ppGroup

Ein Verweis auf ISharedPropertyGroup, bei der es sich um eine freigegebene Eigenschaftengruppe handelt, die durch den Name-Parameter identifiziert wird, oder NULL , wenn ein Fehler auftritt.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_OUTOFMEMORY, E_UNEXPECTED und E_FAIL sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Im ppGroup-Parameter wird ein Verweis auf die freigegebene Eigenschaftengruppe zurückgegeben, die im Parameter Name angegeben ist.
CONTEXT_E_NOCONTEXT	Der Aufrufer wird nicht unter COM+ ausgeführt. Ein Aufrufer muss unter COM+ ausgeführt werden, um den Shared Property Manager zu verwenden.
E_INVALIDARG	Mindestens einer der Parameter ist ungültig, oder dasselbe Objekt versucht mehr als einmal, dieselbe Eigenschaftengruppe zu erstellen.

Hinweise

Die folgenden Konstanten werden verwendet, um den effektiven Isolationsmodus für eine freigegebene Eigenschaftengruppe anzugeben.

Konstante	Wert	BESCHREIBUNG
LockSetGet	0	Der Standardwert. Es stellt sicher, dass jeder Get- oder Set-Vorgang für eine freigegebene Eigenschaft atomar ist, indem die Eigenschaft während des Aufrufs gesperrt wird. Dadurch wird sichergestellt, dass zwei Clients nicht gleichzeitig dieselbe Eigenschaft lesen oder schreiben können, aber es verhindert nicht, dass andere Clients gleichzeitig auf andere Eigenschaften in derselben Gruppe zugreifen.
LockMethod	1	Dieser Wert sperrt alle Eigenschaften in der freigegebenen Eigenschaftengruppe für die exklusive Verwendung durch den Aufrufer, solange die aktuelle Methode des Aufrufers ausgeführt wird. Dies ist der geeignete Modus, der verwendet werden kann, wenn Zwischenabhängigkeiten zwischen Eigenschaften bestehen oder wenn ein Client eine Eigenschaft möglicherweise unmittelbar nach dem Lesen aktualisieren muss, bevor wieder auf sie zugegriffen werden kann.

Hinweis Wenn Sie den Isolationsmodus auf LockMethod festlegen, benötigt der Shared Property Manager Zugriff auf den Objektkontext des aufrufenden Objekts. Sie können diesen Isolationsmodus nicht verwenden, um eine freigegebene Eigenschaftengruppe aus dem Konstruktor eines Objekts oder aus einem Nicht-COM+-Objekt zu erstellen, da der Objektkontext während der Objekterstellung nicht verfügbar ist und ein Basisclient keinen Objektkontext aufweist.

Die folgenden Konstanten werden verwendet, um den effektiven Freigabemodus für eine freigegebene Eigenschaftengruppe anzugeben.

Konstante	Wert	BESCHREIBUNG
Standard	0	Der Standardwert. Wenn alle Clients ihre Verweise auf die Eigenschaftengruppe freigegeben haben, wird diese automatisch zerstört.
Prozess	1	Die Eigenschaftengruppe wird nicht zerstört, solange der Prozess nicht beendet ist, in der sie erstellt wurde. Objekte, die Verweise auf eine Eigenschaftengruppe enthalten, müssen weiterhin Release für ihre Verweise aufrufen.

Hinweis Ein -Objekt sollte niemals versuchen, einen Freigegebenen Eigenschaftengruppenverweis an ein anderes Objekt zu übergeben. Wenn der Verweis außerhalb des Objekts übergeben wird, das ihn abgerufen hat, ist er kein gültiger Verweis mehr.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	comsvcs.h

Weitere Informationen

ISharedPropertyGroupManager

Share via