Struct std::os::windows::io::OwnedHandle

pub struct OwnedHandle { /* fields omitted */ }

🔬 This is a nightly-only experimental API. (io_safety #87074)

This is supported on Windows only.

拥有所有权的句柄。

这将会丢弃时关闭句柄。

请注意，它可能具有值 INVALID_HANDLE_VALUE (-1)，有时这是一个有效的句柄值。有关完整故事，请参见 这个。

并且，它可能具有值 NULL (0)，当控制台与进程分离或使用 windows_subsystem 时，可能会发生这种情况。

OwnedHandle 使用 CloseHandle 在关闭时丢弃其句柄。 因此，它不能与句柄一起使用来打开需要用 RegCloseKey 关闭的注册表项。

Trait Implementations

impl AsHandle for OwnedHandle

fn as_handle(&self) -> BorrowedHandle<'_>

🔬 This is a nightly-only experimental API. (io_safety #87074)

借用句柄。

impl AsRawHandle for OwnedHandle

fn as_raw_handle(&self) -> RawHandle

提取原始句柄，无需任何所有权。

impl Debug for OwnedHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

使用给定的格式化程序格式化该值。

impl Drop for OwnedHandle

fn drop(&mut self)

执行此类型的析构函数。

impl From<Child> for OwnedHandle

fn from(child: Child) -> OwnedHandle

执行转换。

impl From<ChildStderr> for OwnedHandle

fn from(child_stderr: ChildStderr) -> OwnedHandle

执行转换。

impl From<ChildStdin> for OwnedHandle

fn from(child_stdin: ChildStdin) -> OwnedHandle

执行转换。

impl From<ChildStdout> for OwnedHandle

fn from(child_stdout: ChildStdout) -> OwnedHandle

执行转换。

impl From<File> for OwnedHandle

fn from(file: File) -> OwnedHandle

执行转换。

impl<T> From<JoinHandle<T>> for OwnedHandle

fn from(join_handle: JoinHandle<T>) -> OwnedHandle

执行转换。

impl From<OwnedHandle> for File

fn from(owned: OwnedHandle) -> Self

执行转换。

impl From<OwnedHandle> for Stdio

fn from(handle: OwnedHandle) -> Stdio

执行转换。

impl FromRawHandle for OwnedHandle

unsafe fn from_raw_handle(handle: RawHandle) -> Self

从给定的原始句柄构造 Self 的新实例。

Safety

handle 指向的资源必须是开放的并且适合承担所有权。 除了 CloseHandle 之外，资源不得需要任何清理。

特别是，它不能与句柄一起使用来打开需要用 RegCloseKey 关闭的注册表项。

请注意，它可能具有值 INVALID_HANDLE_VALUE (-1)，有时这是一个有效的句柄值。 有关完整故事，请参见 这个。

impl IntoRawHandle for OwnedHandle

fn into_raw_handle(self) -> RawHandle

消耗此对象，返回原始底层句柄。

impl TryFrom<HandleOrInvalid> for OwnedHandle

type Error = ()

发生转换错误时返回的类型。

fn try_from(handle_or_invalid: HandleOrInvalid) -> Result<Self, ()>

执行转换。

impl TryFrom<HandleOrNull> for OwnedHandle

type Error = ()

发生转换错误时返回的类型。

fn try_from(handle_or_null: HandleOrNull) -> Result<Self, ()>

执行转换。

impl Send for OwnedHandle

impl Sync for OwnedHandle