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

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

ISharedProperty

ISharedPropertyGroup