IAzRole::AddPropertyItem 方法 (azroles.h)

AddPropertyItem 方法将指定的实体添加到指定的列表中。

语法

HRESULT AddPropertyItem(
  [in]           LONG    lPropId,
  [in]           VARIANT varProp,
  [in, optional] VARIANT varReserved
);

参数

[in] lPropId

要向其添加 varProp 参数指定的实体的列表的属性 ID。 下表列出了可能的值。

“值” 含义
AZ_PROP_ROLE_APP_MEMBERS
也可以使用 AddAppMember 方法添加
AZ_PROP_ROLE_MEMBERS
也可以使用 AddMember 方法添加
AZ_PROP_ROLE_MEMBERS_NAME
也可以使用 AddMemberName 方法添加
AZ_PROP_ROLE_OPERATIONS
也可以使用 AddOperation 方法添加
AZ_PROP_ROLE_TASKS
也可以使用 AddTask 方法添加

[in] varProp

要添加到 由 lPropId 参数指定的列表的实体。

变体必须是 BSTR 变体。

如果为 lPropId 参数指定了AZ_PROP_ROLE_MEMBERS,则字符串是要添加到列表的 Windows 帐户 (SID) 的安全标识符 的文本形式。 如果为 lPropId 参数指定了 AZ_PROP_ROLE_MEMBERS_NAME,则字符串是要添加到列表的帐户的帐户名称。 帐户名称可以是用户主体名称 (UPN) 格式 (例如“”someone@example.com) 或“ExampleDomain\UserName”格式。 如果为 lPropId 参数指定了 AZ_PROP_ROLE_APP_MEMBERS,则字符串是要添加到列表的 IAzApplicationGroup 对象的 Name 属性。

[in, optional] varReserved

保留供将来使用。

返回值

返回值为 HRESULT。 值为 S_OK 表示成功。 任何其他值指示操作失败。

注解

必须调用 Submit 方法才能保留此方法所做的任何更改。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 azroles.h
Library Azroles.lib
DLL Azroles.dll
可再发行组件 Windows XP 上的 Windows Server 2003 管理工具包