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