Win32_Printer 類別的 GetSecurityDescriptor 方法
GetSecurityDescriptor方法會傳回控制印表機存取權的安全性描述項。 描述項會當做 Win32_SecurityDescriptor的實例傳回。 如需詳細資訊，請參閱 變更安全性實體物件的存取安全性。
本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫方法。
語法
uint32 GetSecurityDescriptor(
[out] Win32_SecurityDescriptor Descriptor
);
參數
-
描述元 [out]
-
與印表機相關聯的安全描述項。
傳回值
傳回下列清單中所列的其中一個值，或傳回不同的值來表示錯誤。 如需其他錯誤碼，請參閱 WMI 錯誤常數 或 WbemErrorEnum。 如需一般 HRESULT 值，請參閱 系統錯誤碼。
-
0
-
成功完成。
-
2
-
使用者無法存取要求的資訊。
-
8
-
未知的失敗。
-
9
-
使用者沒有足夠的許可權可執行 方法。
-
21
-
方法呼叫中指定的參數無效。
備註
Win32_SecurityDescriptor實例代表SECURITY_DESCRIPTOR_CONTROL資料類型，並包含 DACL) (DACL 的任意存取控制清單，以及 SACL) 的系統存取控制 (清單。 如需詳細資訊，請參閱存取控制清單。
如果在取得安全性描述元時未授與或啟用 SeSecurityPrivilege ，則只會在傳回的安全性描述元中傳回 DACL。 如需詳細資訊，請參閱 許可權常數 和執行 特殊許可權作業。
範例
下列 VBScript 程式碼範例會列出附加至本機電腦的印表機，並取得每部印表機的安全性描述項。 然後會擷取 DACL) 的任意存取控制 (清單中 (ACE) 存取控制專案，以判斷哪些使用者可以存取印表機。
SE_DACL_PRESENT = &h4
ACCESS_ALLOWED_ACE_TYPE = &h0
ACCESS_DENIED_ACE_TYPE = &h1
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate, (Security)}!\\" & strComputer & "\root\cimv2")
Set objWMIService = GetObject("winmgmts:")
Set colInstalledPrinters = objWMIService.ExecQuery _
("Select * from Win32_Printer")
For Each objPrinter in colInstalledPrinters
Wscript.Echo "Name: " & objPrinter.Name
' Get security descriptor for printer
Return = objPrinter.GetSecurityDescriptor( objSD )
If ( return <> 0 ) Then
WScript.Echo "Could not get security descriptor: " & Return
wscript.Quit Return
End If
' Extract the security descriptor flags
intControlFlags = objSD.ControlFlags
If intControlFlags AND SE_DACL_PRESENT Then
' Get the ACE entries from security descriptor
arrACEs = objSD.DACL
For Each objACE in arrACEs
' Get all the trustees and determine which have access to printer
WScript.Echo objACE.Trustee.Domain & "\" & objACE.Trustee.Name
If objACE.AceType = ACCESS_ALLOWED_ACE_TYPE Then
WScript.Echo vbTab & "User has access to printer"
ElseIf objACE.AceType = ACCESS_DENIED_ACE_TYPE Then
WScript.Echo vbTab & "User does not have access to the printer"
End If
Next
Else
WScript.Echo "No DACL found in security descriptor"
End If
Next
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|