IAzRole::AddPropertyItem 方法 (azroles.h)
AddPropertyItem 方法會將指定的實體新增至指定的清單。
語法
HRESULT AddPropertyItem(
[in] LONG lPropId,
[in] VARIANT varProp,
[in, optional] VARIANT varReserved
);
參數
[in] lPropId
要加入 varProp 參數所指定之實體的清單屬性識別碼。 下表顯示可能的值。
值 | 意義 |
---|---|
|
也可以使用 AddAppMember 方法來新增 |
|
也可以使用 AddMember 方法新增 |
|
也可以使用 AddMemberName 方法新增 |
|
也可以使用 AddOperation 方法來新增 |
|
也可以使用 AddTask 方法新增 |
[in] varProp
要加入至 lPropId 參數所指定清單的實體。
變體必須是 BSTR 變體。
如果已為 lPropId 參數指定AZ_PROP_ROLE_MEMBERS,則字串會是要新增至清單之 Windows 帳戶 (S) ID (安全性識別符 的文字形式。 如果為 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 |
程式庫 | Azroles.lib |
Dll | Azroles.dll |
可轉散發套件 | Windows XP 上的 Windows Server 2003 系統管理工具套件 |