Метод 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

См. также раздел

ISharedProperty

ISharedPropertyGroup