Share via

ISharedPropertyGroup::CreateProperty-Methode (comsvcs.h)

  • Artikel

Erstellt eine neue freigegebene Eigenschaft mit dem angegebenen Namen. Wenn bereits eine freigegebene Eigenschaft mit diesem Namen vorhanden ist, gibt CreateProperty einen Verweis auf die vorhandene Eigenschaft zurück.

Syntax

HRESULT CreateProperty(
  [in]  BSTR            Name,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

Parameter

[in] Name

Der Name der zu erstellenden Eigenschaft. Sie können diesen Namen später verwenden, um mithilfe der get_Property-Methode einen Verweis auf diese Eigenschaft abzurufen.

[out] fExists

Ein Verweis auf einen booleschen Wert, der bei der Rückgabe von dieser Methode auf VARIANT_TRUE festgelegt ist, wenn die im Name-Parameter angegebene freigegebene Eigenschaft vor diesem Aufruf vorhanden war, und VARIANT_FALSE, wenn die Eigenschaft durch diesen Aufruf erstellt wurde.

[out] ppProp

Ein Verweis auf ein SharedProperty-Objekt mit dem im Parameter Name angegebenen Namen oder NULL , wenn ein Fehler auftritt.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL und S_OK zurückgeben.

Hinweise

Wenn Sie eine freigegebene Eigenschaft erstellen, wird deren Wert auf den Standardwert festgelegt, bei dem es sich um eine VT_I4 VARIANT mit dem Wert 0 handelt.

Wenn Sie eine freigegebene Eigenschaft mit der CreateProperty-Methode erstellen, können Sie nur mit der get_Property-Methode auf diese Eigenschaft zugreifen. Sie können der gleichen Eigenschaft keinen numerischen Index zuweisen und dann mit der get_PropertyByPosition-Methode darauf zugreifen.

Dieselbe freigegebene Eigenschaftengruppe kann einige SharedProperty-Objekte enthalten, die anhand des Namens identifiziert werden, und andere, die anhand der Position identifiziert werden.

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

ISharedProperty

ISharedPropertyGroup