ISharedPropertyGroup::CreatePropertyByPosition-Methode (comsvcs.h)
Erstellt eine neue freigegebene Eigenschaft mit dem angegebenen Index. Wenn bereits eine freigegebene Eigenschaft mit dem angegebenen Index vorhanden ist, gibt CreatePropertyByPosition einen Verweis auf die vorhandene zurück.
Syntax
HRESULT CreatePropertyByPosition(
[in] int Index,
[out] VARIANT_BOOL *fExists,
[out] ISharedProperty **ppProp
);
Parameter
[in] Index
Der numerische Index im SharedPropertyGroup-Objekt , auf das auf die neue Eigenschaft verwiesen wird. Sie können diesen Index später verwenden, um die freigegebene Eigenschaft mit der get_PropertyByPosition-Methode abzurufen.
[out] fExists
Ein Verweis auf einen booleschen Wert. Wenn fExists bei der Rückgabe von dieser Methode auf VARIANT_TRUE festgelegt ist, war die von Index angegebene freigegebene Eigenschaft vor diesem Aufruf vorhanden. Wenn sie auf VARIANT_FALSE festgelegt ist, wurde die Eigenschaft durch diesen Aufruf erstellt.
[out] ppProp
Ein Verweis auf ein freigegebenes Eigenschaftsobjekt, das durch den numerischen Index identifiziert wird, der im Index-Parameter übergeben wird, 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 ein SharedProperty-Objekt mit der CreatePropertyByPosition-Methode erstellen, können Sie nur mit der get_PropertyByPosition-Methode auf diese Eigenschaft zugreifen. Sie können derselben Eigenschaft keinen Zeichenfolgennamen zuweisen und dann mit der get_Property-Methode darauf zugreifen. Der Zugriff auf eine Eigenschaft nach Position ist schneller als der Zugriff auf eine Eigenschaft mithilfe eines Zeichenfolgennamens, da er weniger Aufwand erfordert.
Dieselbe freigegebene Eigenschaftengruppe kann einige SharedProperty-Objekte enthalten, die anhand der Position identifiziert werden, und andere, die anhand des Namens 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 |