Crate windows_permissions

Windows permissions

Safe Rust bindings to Windows permissions APIs.

Overview

This crate provides safe Rust wrappers over several Windows permissions concepts, including:

• SID (Security Identifier)
• ACL (Access Control List)
• ACE (Access Control Entry)
• SD (Security Descriptor)

There are two kinds of abstractions:

• The primary Windows data structures are available and can be used directly.
• In the wrappers crate, there are safe versions of the Windows API functions. Any Windows API function not implemented should be reported as an issue.

Contributing

PRs are happily accepted! In general, unsafe code should be confined to the wrappers module – the rest of this crate should be implemented safely based on that code.

Help wanted:

• Make wrappers more complete with additional Windows API functions
• Add new data structures that cover more of the permissions APIs

Re-exports

pub use localheap::LocalBox;

Modules

constants

Constants related to Windows security.

localheap

A specialized Box variation for items stored on the local heap.

structures

Data structures related to Windows security.

utilities

Minor utilities for working with Windows APIs.

wrappers

Direct wrappers over WinAPI calls

Structs

Ace

An access control list.

Acl

An entry in an access control list (ACL).

SecurityDescriptor

A Windows security descriptor.

Sid

A SID (Security Identifier) that can be used with Windows API calls.

Trustee

An entity that can be added to an ACL.

Traits

WindowsSecure

A trait indicating that an object is subject to Windows security.