IAzAuthorizationStore::AddPropertyItem 方法 (azroles.h)

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

语法

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

参数

[in] lPropId

要向其添加 varProp 参数所指定的主体的主体列表的属性 ID。 此参数的取值可为下列值之一:

含义
AZ_PROP_POLICY_ADMINS
也可以使用 AddPolicyAdministrator 方法进行添加
AZ_PROP_POLICY_ADMINS_NAME
也可以使用 AddPolicyAdministratorName 方法添加。
AZ_PROP_POLICY_READERS
也可以使用 AddPolicyReader 方法进行添加
AZ_PROP_POLICY_READERS_NAME
也可以使用 AddPolicyReaderName 方法进行添加
AZ_PROP_DELEGATED_POLICY_USERS
也可以使用 AddDelegatedPolicyUser 方法进行添加。
AZ_PROP_DELEGATED_POLICY_USERS_NAME
也可以使用 AddDelegatedPolicyUserName 方法添加。

[in] varProp

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

变体必须是 BSTR 变体。

如果为 lPropId 参数指定了AZ_PROP_POLICY_ADMINS_NAME、AZ_PROP_POLICY_READERS_NAME或AZ_PROP_DELEGATED_POLICY_USERS_NAME,则字符串是要添加到列表中的帐户的帐户名称。 帐户名称必须采用 用户主体名称 (UPN) 格式, (例如“”someone@example.com) 。

[in, optional] varReserved

保留供将来使用。

返回值

如果方法成功,该方法将返回S_OK。

如果方法失败,它将返回一个 指示错误的 HRESULT 值。 有关常见错误代码的列表,请参阅 通用 HRESULT 值

注解

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

要求

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