1use crate::io; 2use core::mem::MaybeUninit; 3use windows_sys::Win32::Networking::WinSock::{WSACleanup, WSAGetLastError, WSAStartup, WSADATA}; 4 5/// `WSAStartup()`—Initialize process-wide Windows support for sockets. 6/// 7/// On Windows, it's necessary to initialize the sockets subsystem before 8/// using sockets APIs. The function performs the necessary initialization. 9/// 10/// # References 11/// - [Winsock2] 12/// 13/// [Winsock2]: https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsastartup 14pub fn wsa_startup() -> io::Result<WSADATA> { 15 // Request version 2.2, which has been the latest version since far older 16 // versions of Windows than we support here. For more information about 17 // the version, see [here]. 18 // 19 // [here]: https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsastartup#remarks 20 let version = 0x202; 21 let mut data = MaybeUninit::uninit(); 22 unsafe { 23 let ret = WSAStartup(version, data.as_mut_ptr()); 24 if ret == 0 { 25 Ok(data.assume_init()) 26 } else { 27 Err(io::Errno::from_raw_os_error(WSAGetLastError())) 28 } 29 } 30} 31 32/// `WSACleanup()`—Clean up process-wide Windows support for sockets. 33/// 34/// In a program where `init` is called, if sockets are no longer necessary, 35/// this function releases associated resources. 36/// 37/// # References 38/// - [Winsock2] 39/// 40/// [Winsock2]: https://docs.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-wsacleanup 41pub fn wsa_cleanup() -> io::Result<()> { 42 unsafe { 43 if WSACleanup() == 0 { 44 Ok(()) 45 } else { 46 Err(io::Errno::from_raw_os_error(WSAGetLastError())) 47 } 48 } 49} 50