Skip to content

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

NameTypeDescription
value (Str | Sid | Bin | WellKnownSid) Account name, or a SID as a Sid, native packet, or well-known SID.

Errors

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

Fields

domain @ Str

Account domain returned by Windows.

kind @ SidNameUse

How Windows classifies the SID.

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

Unqualified account name.

qualified_name @ Str

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

sid @ Sid

The resolved SID.