Méthode ISharedPropertyGroup ::CreatePropertyByPosition (comsvcs.h)

Article
08/22/2023

Crée une propriété partagée avec l’index spécifié. Si une propriété partagée avec l’index spécifié existe déjà, CreatePropertyByPosition retourne une référence à celle existante.

Syntaxe

HRESULT CreatePropertyByPosition(
  [in]  int             Index,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

Paramètres

[in] Index

Index numérique dans l’objet SharedPropertyGroup par lequel la nouvelle propriété est référencée. Vous pouvez utiliser cet index ultérieurement pour récupérer la propriété partagée avec la méthode get_PropertyByPosition .

[out] fExists

Référence à une valeur booléenne. Si fExists est défini sur VARIANT_TRUE en retour de cette méthode, la propriété partagée spécifiée par Index existait avant cet appel. Si elle est définie sur VARIANT_FALSE, la propriété a été créée par cet appel.

[out] ppProp

Référence à un objet de propriété partagé identifié par l’index numérique transmis dans le paramètre Index , ou NULL si une erreur est rencontrée.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL et S_OK.

Remarques

Lorsque vous créez une propriété partagée, sa valeur est définie sur la valeur par défaut, qui est une VT_I4 VARIANT avec la valeur 0.

Si vous créez un objet SharedProperty avec la méthode CreatePropertyByPosition , vous pouvez accéder à cette propriété uniquement à l’aide de la méthode get_PropertyByPosition . Vous ne pouvez pas attribuer un nom de chaîne à la même propriété, puis y accéder à l’aide de la méthode get_Property . L’accès à une propriété par position est plus rapide que l’accès à une propriété à l’aide d’un nom de chaîne, car cela nécessite moins de surcharge.

Le même groupe de propriétés partagé peut contenir certains objets SharedProperty qui sont identifiés par position et d’autres qui sont identifiés par nom.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	comsvcs.h

Voir aussi

ISharedProperty

ISharedPropertyGroup

Partager via