Share via

ISharedPropertyGroup::CreatePropertyByPosition-Methode (comsvcs.h)

  • Artikel

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

Weitere Informationen

ISharedProperty

ISharedPropertyGroup