SWbemPrivilegeSet.Add 方法
SWbemPrivilegeSet物件的Add方法會將SWbemPrivilege物件新增至SWbemPrivilegeSet集合。 如果集合中已經有相同名稱的許可權,則會取代它。
如需此語法的說明,請參閱 腳本 API 的檔慣例。
語法
objPrivilege = .Add( _
ByVal iPrivilege, _
[ ByVal bIsEnabled ] _
)
參數
-
iPrivilege
-
必要。 WbemPrivilegeEnum群組中的其中一個 WMI 常數。 這些常數基本上是代表特定許可權的整數。 例如,若要新增可讓您關閉電腦系統的許可權,請使用 wbemPrivilegeShutdown 常數。 在腳本中,您必須使用 23 (0x17) 的數值。 如需這些常數和相關聯許可權字串的完整清單,請參閱 Privilege Constants。
-
bIsEnabled [選擇性]
-
啟用或停用此許可權的布林值。 預設值為 TRUE。
傳回值
如果成功,此方法會傳回代表新許可權的 SWbemPrivilege 物件。 否則會傳回 Null 物件。
錯誤碼
完成 Add方法之後,Err物件可能會包含下列清單中的錯誤碼。
-
wbemErrFailed - 2147749889 (0x80041001)
-
未指定的錯誤。
範例
使用此方法的程式碼範例會在 SWbemPrivilegeSet 主題中說明。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
標頭 |
|
類型程式庫 |
|
DLL |
|
CLSID |
CLSID_SWbemPrivilegeSet |
IID |
IID_ISWbemPrivilegeSet |