Метод ISharedPropertyGroup::CreateProperty (comsvcs.h)
Создает новое общее свойство с указанным именем. Если общее свойство с таким именем уже существует, CreateProperty возвращает ссылку на существующее свойство.
Синтаксис
HRESULT CreateProperty(
[in] BSTR Name,
[out] VARIANT_BOOL *fExists,
[out] ISharedProperty **ppProp
);
Параметры
[in] Name
Имя создаваемого свойства. Это имя можно использовать позже, чтобы получить ссылку на это свойство с помощью метода get_Property .
[out] fExists
Ссылка на логическое значение, для которой задано значение VARIANT_TRUE при возврате из этого метода, если общее свойство, указанное в параметре Name , существовало до этого вызова, и VARIANT_FALSE, если свойство было создано этим вызовом.
[out] ppProp
Ссылка на объект SharedProperty с именем, указанным в параметре Name , или null при обнаружении ошибки.
Возвращаемое значение
Этот метод может возвращать стандартные возвращаемые значения E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL и S_OK.
Комментарии
При создании общего свойства ей присваивается значение по умолчанию, которое является VT_I4 VARIANT со значением 0.
При создании общего свойства с помощью метода CreateProperty доступ к свойству можно получить только с помощью метода get_Property . Нельзя назначить числовый индекс тому же свойству, а затем получить к нему доступ с помощью метода get_PropertyByPosition .
Та же группа общих свойств может содержать некоторые объекты SharedProperty , которые идентифицируются по имени, а другие — по позиции.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | comsvcs.h |