ISharedPropertyGroup::CreateProperty 方法 (comsvcs.h)

创建具有指定名称的新共享属性。 如果已存在该名称的共享属性, CreateProperty 将返回对现有属性的引用。

语法

HRESULT CreateProperty(
  [in]  BSTR            Name,
  [out] VARIANT_BOOL    *fExists,
  [out] ISharedProperty **ppProp
);

参数

[in] Name

要创建的属性的名称。 稍后可以使用此名称来获取对此属性的引用,方法是使用 get_Property 方法。

[out] fExists

如果在此调用之前存在 Name 参数中指定的共享属性,则对布尔值的引用设置为从此方法返回时VARIANT_TRUE;如果此调用创建了属性,则VARIANT_FALSE。

[out] ppProp

对 Name 参数中指定的名称的 SharedProperty 对象的引用;如果遇到错误,则为 NULL

返回值

此方法可以返回E_INVALIDARG、E_OUTOFMEMORY、E_UNEXPECTED、E_FAIL和S_OK的标准返回值。

注解

创建共享属性时,其值设置为默认值,即值为 0 的VT_I4 VARIANT。

如果使用 CreateProperty 方法创建共享属性,则只能通过使用 get_Property 方法访问该属性。 不能将数字索引分配给同一属性,然后使用 get_PropertyByPosition 方法对其进行访问。

同一共享属性组可以包含一些 SharedProperty 对象,这些对象由名称标识,其他对象则由位置标识。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 comsvcs.h

另请参阅

ISharedProperty

ISharedPropertyGroup