ISharedPropertyGroup::CreateProperty-Methode (comsvcs.h)
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 |