Struct std::os::windows::io::BorrowedHandle

#[repr(transparent)]
pub struct BorrowedHandle<'handle> { /* private fields */ }

Available on Windows only.

借来的句柄。

它有一个生命周期参数，将它与拥有句柄的事物的生命周期联系起来。

这使用 repr(transparent) 并具有主机句柄的表示形式，因此它可以在 FFI 中将句柄作为参数传递的地方使用，它不会被捕获或消耗。

请注意，它可能具有值 -1，它在 BorrowedHandle 中始终表示有效的句柄值，例如 the current process handle，而不是 INVALID_HANDLE_VALUE，尽管两者具有相同的值。 有关完整故事，请参见 这个。

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

这种类型的 .to_owned() 实现返回另一个 BorrowedHandle 而不是 OwnedHandle。它只是简单地复制原始句柄，然后在相同的生命周期下借用。

Implementations

impl BorrowedHandle<'_>

pub const unsafe fn borrow_raw(handle: RawHandle) -> Self

返回一个 BorrowedHandle 持有给定的原始句柄。

Safety

handle 指向的资源必须是有效的打开句柄，它必须在返回的 BorrowedHandle 期间保持打开状态。

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

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

impl BorrowedHandle<'_>

pub fn try_clone_to_owned(&self) -> Result<OwnedHandle>

创建一个新的 OwnedHandle 实例，该实例与现有 BorrowedHandle 实例共享相同的底层 object。

Trait Implementations

impl AsHandle for BorrowedHandle<'_>

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

借用句柄。

impl AsRawHandle for BorrowedHandle<'_>

fn as_raw_handle(&self) -> RawHandle

提取原始句柄。

impl<'handle> Clone for BorrowedHandle<'handle>

fn clone(&self) -> BorrowedHandle<'handle>

返回值的副本。

fn clone_from(&mut self, source: &Self)

从 source 执行复制分配。

impl Debug for BorrowedHandle<'_>

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

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

impl IsTerminal for BorrowedHandle<'_>

fn is_terminal(&self) -> bool

如果 descriptor/handle 引用 terminal/tty，则返回 true。

impl<'handle> Copy for BorrowedHandle<'handle>

impl Send for BorrowedHandle<'_>

impl Sync for BorrowedHandle<'_>