SidName

Resolved Windows account identity.

Class Methods

lookup value -> SidName

Resolves an account name or SID in the active VFS target.

A Str is always an account name, never a SID in its canonical string form.

Parameters

Name	Type	Description
value	(Str | Sid | Bin | WellKnownSid)	Account name, or a SID as a Sid, binary form, or well-known SID.

Errors

Exception	Condition
sys.NotFoundError	The identity is unmapped
UnsupportedError	The active VFS target is Unix

Fields

domain @ Str ^[get]

Account domain returned by Windows.

kind @ SidNameUse ^[get]

How Windows classifies the SID.

Example

let account = SidName.lookup BUILTIN\Users
echo "$(account.qualified_name) ($(account.kind))"

name @ Str ^[get]

Unqualified account name.

qualified_name @ Str ^[get]

The domain\name form, or name when the domain is empty.

sid @ Sid ^[get]

The resolved SID.