[−][src]Struct winapi_util::Handle
A handle represents an owned and valid Windows handle to a file-like object.
When an owned handle is dropped, then the underlying raw handle is closed.
To get a borrowed handle, use HandleRef
.
Methods
impl Handle
[src]
pub fn from_file(file: File) -> Handle
[src]
Create an owned handle to the given file.
When the returned handle is dropped, the file is closed.
Note that if the given file represents a handle to a directory, then
it is generally required that it have been opened with the
FILE_FLAG_BACKUP_SEMANTICS
flag in order to use it in various
calls such as information
or typ
. To have this done automatically
for you, use the from_path_any
constructor.
pub fn from_path<P: AsRef<Path>>(path: P) -> Result<Handle>
[src]
Open a file to the given file path, and return an owned handle to that file.
When the returned handle is dropped, the file is closed.
If there was a problem opening the file, then the corresponding error is returned.
pub fn from_path_any<P: AsRef<Path>>(path: P) -> Result<Handle>
[src]
Like from_path
, but supports opening directory handles as well.
If you use from_path
on a directory, then subsequent queries using
that handle will fail.
pub fn as_file(&self) -> &File
[src]
Return this handle as a standard File
reference.
pub fn as_file_mut(&mut self) -> &mut File
[src]
Return this handle as a standard File
mutable reference.
Trait Implementations
impl AsHandleRef for Handle
[src]
impl AsRawHandle for Handle
[src]
fn as_raw_handle(&self) -> RawHandle
[src]
impl Debug for Handle
[src]
impl FromRawHandle for Handle
[src]
unsafe fn from_raw_handle(handle: RawHandle) -> Handle
[src]
impl IntoRawHandle for Handle
[src]
fn into_raw_handle(self) -> RawHandle
[src]
Auto Trait Implementations
impl RefUnwindSafe for Handle
impl Send for Handle
impl Sync for Handle
impl Unpin for Handle
impl UnwindSafe for Handle
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,