IAzScope：：AddPropertyItem 方法 (azroles.h)

AddPropertyItem 方法會將指定的主體新增至指定的主體清單。

語法

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

參數

[in] lPropId

要加入 varProp 參數所指定之主體之主體清單的屬性標識碼。 下表顯示可能的值。

值	意義
AZ_PROP_POLICY_ADMINS	也可以使用 AddPolicyAdministrator 方法新增
AZ_PROP_POLICY_ADMINS_NAME	也可以使用 AddPolicyAdministratorName 方法新增
AZ_PROP_POLICY_READERS	也可以使用 AddPolicyReader 方法新增
AZ_PROP_POLICY_READERS_NAME	也可以使用 AddPolicyReaderName 方法新增

[in] varProp

要新增至 lPropId 參數所指定主體清單的主體。

變異必須是 BSTR 變體。

如果為 lPropId 參數指定AZ_PROP_POLICY_ADMINS或AZ_PROP_POLICY_READERS，則字串是 Windows 帳戶 (SID) 要新增至清單 的安全性識別碼 文字形式。 如果為 lPropId 參數指定AZ_PROP_POLICY_ADMINS_NAME或AZ_PROP_POLICY_READERS_NAME，則字串是要新增至清單的帳戶帳戶名稱。 帳戶名稱可以是 (UPN) (格式的用戶主體名稱，例如 “someone@example.com”) 或 “ExampleDomain\UserName” 格式。

[in, optional] varReserved

保留供未來使用。

傳回值

傳回值為 HRESULT。 值S_OK表示成功。 任何其他值都表示作業失敗。

備註

您必須呼叫 Submit 方法，才能保存此方法所做的任何變更。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	azroles.h
程式庫	Azroles.lib
Dll	Azroles.dll
可轉散發套件	Windows XP 上的 Windows Server 2003 系統管理工具套件