Win32_Trustee Class (Windows)

Win32_Trustee Class

Win32_Trustee Class

The Win32_Trustee abstract WMI class specifies a trustee that can be a name or a security identifier (SID) byte array.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties and methods are in alphabetic order, not MOF order.

Syntax

class Win32_Trustee : __Trustee
{
  string Domain;
  string Name;
  uint8  SID[];
  uint32 SidLength;
  string SIDString;
};

Inheritance

Windows Server 2003, Windows XP, Windows 2000, Windows XP, and Windows NT 4.0: Inherits from the Win32_MethodParameterClass.

Methods

The Win32_Trustee class does not define any methods.

Properties

The Win32_Trustee class defines the following properties.

Domain

Data type: string
Access type: Read/write
Qualifiers: WritePrivileges(SeSecurityPrivilege, SeRestorePrivilege)

Domain to which a trustee belongs.

Name

Data type: string
Access type: Read/write
Qualifiers: WritePrivileges(SeSecurityPrivilege, SeRestorePrivilege)

A trustee can be a user account, group account, or logon session.

SID

Data type: uint8 array
Access type: Read/write
Qualifiers: WritePrivileges(SeSecurityPrivilege, SeRestorePrivilege)

SID that uniquely identifies a user or group.

SidLength

Data type: uint32
Access type: Read/write
Qualifiers: WritePrivileges(SeSecurityPrivilege, SeRestorePrivilege)

Length of a SID—in bytes.

SIDString

Data type: string
Access type: Read/write
Qualifiers: WritePrivileges(SeSecurityPrivilege, SeRestorePrivilege)

SID of a trustee in string format. The format for a string value is the following:

The "S" character identifies the series of digits as a SID.
The revision level.
Identifier authority value.
One or more subauthority values.

Example: "S-1-1-0"

Remarks

The Win32_Trustee class is derived from the Win32_MethodParameterClass. For more information about how to provide SID data to an instance of this class, see Changing Access Security on Securable Objects.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
MOF	Secrcw32.mof
DLL	Cimwin32.dll
Namespace	\root\cimv2