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。

注解

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

如果使用 CreatePropertyByPosition 方法创建 SharedProperty 对象，则只能使用 get_PropertyByPosition 方法访问该属性。 不能将字符串名称分配给同一属性，然后使用 get_Property 方法对其进行访问。 按位置访问属性比使用字符串名称访问属性要快，因为它需要的开销更少。

同一个共享属性组可以包含一些 SharedProperty 对象（由位置标识）和其他由名称标识的对象。

要求

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

另请参阅

ISharedProperty

ISharedPropertyGroup