Trait std::os::windows::fs::OpenOptionsExt1.10.0 [] [src]

pub trait OpenOptionsExt {
    fn access_mode(&mut self, access: u32) -> &mut Self;
    fn share_mode(&mut self, val: u32) -> &mut Self;
    fn custom_flags(&mut self, flags: u32) -> &mut Self;
    fn attributes(&mut self, val: u32) -> &mut Self;
    fn security_qos_flags(&mut self, flags: u32) -> &mut OpenOptions;
}

Windows-specific extensions to OpenOptions

Required Methods

Overrides the dwDesiredAccess argument to the call to CreateFile with the specified value.

This will override the read, write, and append flags on the OpenOptions structure. This method provides fine-grained control over the permissions to read, write and append data, attributes (like hidden and system) and extended attributes.

Examples

use std::fs::OpenOptions;
use std::os::windows::fs::OpenOptionsExt;

// Open without read and write permission, for example if you only need
// to call `stat()` on the file
let file = OpenOptions::new().access_mode(0).open("foo.txt");Run

Overrides the dwShareMode argument to the call to CreateFile with the specified value.

By default share_mode is set to FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE. Specifying less permissions denies others to read from, write to and/or delete the file while it is open.

Examples

use std::fs::OpenOptions;
use std::os::windows::fs::OpenOptionsExt;

// Do not allow others to read or modify this file while we have it open
// for writing
let file = OpenOptions::new().write(true)
                             .share_mode(0)
                             .open("foo.txt");Run

Sets extra flags for the dwFileFlags argument to the call to CreateFile2 (or combines it with attributes and security_qos_flags to set the dwFlagsAndAttributes for CreateFile).

Custom flags can only set flags, not remove flags set by Rusts options. This options overwrites any previously set custom flags.

Examples

extern crate winapi;
use std::fs::OpenOptions;
use std::os::windows::fs::OpenOptionsExt;

let mut options = OpenOptions::new();
options.create(true).write(true);
if cfg!(windows) {
    options.custom_flags(winapi::FILE_FLAG_DELETE_ON_CLOSE);
}
let file = options.open("foo.txt");Run

Sets the dwFileAttributes argument to the call to CreateFile2 to the specified value (or combines it with custom_flags and security_qos_flags to set the dwFlagsAndAttributes for CreateFile).

If a new file is created because it does not yet exist and .create(true) or .create_new(true) are specified, the new file is given the attributes declared with .attributes().

If an existing file is opened with .create(true).truncate(true), its existing attributes are preserved and combined with the ones declared with .attributes().

In all other cases the attributes get ignored.

Examples

extern crate winapi;
use std::fs::OpenOptions;
use std::os::windows::fs::OpenOptionsExt;

let file = OpenOptions::new().write(true).create(true)
                             .attributes(winapi::FILE_ATTRIBUTE_HIDDEN)
                             .open("foo.txt");Run

Sets the dwSecurityQosFlags argument to the call to CreateFile2 to the specified value (or combines it with custom_flags and attributes to set the dwFlagsAndAttributes for CreateFile).

Implementors