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