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

  • Article

Crée une propriété partagée avec le nom spécifié. Si une propriété partagée de ce nom existe déjà, CreateProperty retourne une référence à la propriété existante.

Syntaxe

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

Paramètres

[in] Name

Nom de la propriété à créer. Vous pouvez utiliser ce nom ultérieurement pour obtenir une référence à cette propriété à l’aide de la méthode get_Property .

[out] fExists

Référence à une valeur booléenne définie sur VARIANT_TRUE en retour de cette méthode si la propriété partagée spécifiée dans le paramètre Name existait avant cet appel et VARIANT_FALSE si la propriété a été créée par cet appel.

[out] ppProp

Référence à un objet SharedProperty avec le nom spécifié dans le paramètre Name , 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 une propriété partagée avec la méthode CreateProperty , vous pouvez accéder à cette propriété uniquement à l’aide de la méthode get_Property . Vous ne pouvez pas affecter un index numérique à la même propriété, puis y accéder à l’aide de la méthode get_PropertyByPosition .

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

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