1 //! C definitions used by libnative that don't belong in liblibc
3 #![allow(nonstandard_style)]
4 #![cfg_attr(test, allow(dead_code))]
5 #![unstable(issue = "none", feature = "windows_c")]
7 use crate::os::raw::NonZero_c_ulong;
8 use crate::os::raw::{c_char, c_int, c_long, c_longlong, c_uint, c_ulong, c_ushort};
11 use libc::{c_void, size_t, wchar_t};
13 #[path = "c/errors.rs"] // c.rs is included from two places so we need to specify this
17 pub use self::EXCEPTION_DISPOSITION::*;
18 pub use self::FILE_INFO_BY_HANDLE_CLASS::*;
20 pub type DWORD_PTR = ULONG_PTR;
21 pub type DWORD = c_ulong;
22 pub type NonZeroDWORD = NonZero_c_ulong;
23 pub type HANDLE = LPVOID;
24 pub type HINSTANCE = HANDLE;
25 pub type HMODULE = HINSTANCE;
26 pub type HRESULT = LONG;
27 pub type BOOL = c_int;
29 pub type BOOLEAN = BYTE;
30 pub type GROUP = c_uint;
31 pub type LARGE_INTEGER = c_longlong;
32 pub type LONG = c_long;
33 pub type UINT = c_uint;
35 pub type USHORT = c_ushort;
36 pub type SIZE_T = usize;
38 pub type CHAR = c_char;
39 pub type ULONG_PTR = usize;
40 pub type ULONG = c_ulong;
41 pub type NTSTATUS = LONG;
42 pub type ACCESS_MASK = DWORD;
44 pub type LPBOOL = *mut BOOL;
45 pub type LPBYTE = *mut BYTE;
46 pub type LPCSTR = *const CHAR;
47 pub type LPCWSTR = *const WCHAR;
48 pub type LPDWORD = *mut DWORD;
49 pub type LPHANDLE = *mut HANDLE;
50 pub type LPOVERLAPPED = *mut OVERLAPPED;
51 pub type LPPROCESS_INFORMATION = *mut PROCESS_INFORMATION;
52 pub type LPSECURITY_ATTRIBUTES = *mut SECURITY_ATTRIBUTES;
53 pub type LPSTARTUPINFO = *mut STARTUPINFO;
54 pub type LPVOID = *mut c_void;
55 pub type LPWCH = *mut WCHAR;
56 pub type LPWIN32_FIND_DATAW = *mut WIN32_FIND_DATAW;
57 pub type LPWSADATA = *mut WSADATA;
58 pub type LPWSAPROTOCOL_INFO = *mut WSAPROTOCOL_INFO;
59 pub type LPWSTR = *mut WCHAR;
60 pub type LPFILETIME = *mut FILETIME;
61 pub type LPSYSTEM_INFO = *mut SYSTEM_INFO;
62 pub type LPWSABUF = *mut WSABUF;
63 pub type LPWSAOVERLAPPED = *mut c_void;
64 pub type LPWSAOVERLAPPED_COMPLETION_ROUTINE = *mut c_void;
66 pub type PCONDITION_VARIABLE = *mut CONDITION_VARIABLE;
67 pub type PLARGE_INTEGER = *mut c_longlong;
68 pub type PSRWLOCK = *mut SRWLOCK;
70 pub type SOCKET = crate::os::windows::raw::SOCKET;
71 pub type socklen_t = c_int;
72 pub type ADDRESS_FAMILY = USHORT;
74 pub const TRUE: BOOL = 1;
75 pub const FALSE: BOOL = 0;
77 pub const CSTR_LESS_THAN: c_int = 1;
78 pub const CSTR_EQUAL: c_int = 2;
79 pub const CSTR_GREATER_THAN: c_int = 3;
81 pub const FILE_ATTRIBUTE_READONLY: DWORD = 0x1;
82 pub const FILE_ATTRIBUTE_DIRECTORY: DWORD = 0x10;
83 pub const FILE_ATTRIBUTE_REPARSE_POINT: DWORD = 0x400;
85 pub const FILE_SHARE_DELETE: DWORD = 0x4;
86 pub const FILE_SHARE_READ: DWORD = 0x1;
87 pub const FILE_SHARE_WRITE: DWORD = 0x2;
89 pub const CREATE_ALWAYS: DWORD = 2;
90 pub const CREATE_NEW: DWORD = 1;
91 pub const OPEN_ALWAYS: DWORD = 4;
92 pub const OPEN_EXISTING: DWORD = 3;
93 pub const TRUNCATE_EXISTING: DWORD = 5;
95 pub const FILE_WRITE_DATA: DWORD = 0x00000002;
96 pub const FILE_APPEND_DATA: DWORD = 0x00000004;
97 pub const FILE_WRITE_EA: DWORD = 0x00000010;
98 pub const FILE_WRITE_ATTRIBUTES: DWORD = 0x00000100;
99 pub const READ_CONTROL: DWORD = 0x00020000;
100 pub const SYNCHRONIZE: DWORD = 0x00100000;
101 pub const GENERIC_READ: DWORD = 0x80000000;
102 pub const GENERIC_WRITE: DWORD = 0x40000000;
103 pub const STANDARD_RIGHTS_WRITE: DWORD = READ_CONTROL;
104 pub const FILE_GENERIC_WRITE: DWORD = STANDARD_RIGHTS_WRITE
106 | FILE_WRITE_ATTRIBUTES
111 pub const FILE_FLAG_OPEN_REPARSE_POINT: DWORD = 0x00200000;
112 pub const FILE_FLAG_BACKUP_SEMANTICS: DWORD = 0x02000000;
113 pub const SECURITY_SQOS_PRESENT: DWORD = 0x00100000;
115 pub const FIONBIO: c_ulong = 0x8004667e;
119 pub struct WIN32_FIND_DATAW {
120 pub dwFileAttributes: DWORD,
121 pub ftCreationTime: FILETIME,
122 pub ftLastAccessTime: FILETIME,
123 pub ftLastWriteTime: FILETIME,
124 pub nFileSizeHigh: DWORD,
125 pub nFileSizeLow: DWORD,
126 pub dwReserved0: DWORD,
127 pub dwReserved1: DWORD,
128 pub cFileName: [wchar_t; 260], // #define MAX_PATH 260
129 pub cAlternateFileName: [wchar_t; 14],
131 impl Clone for WIN32_FIND_DATAW {
132 fn clone(&self) -> Self {
137 pub const WSA_FLAG_OVERLAPPED: DWORD = 0x01;
138 pub const WSA_FLAG_NO_HANDLE_INHERIT: DWORD = 0x80;
140 pub const WSADESCRIPTION_LEN: usize = 256;
141 pub const WSASYS_STATUS_LEN: usize = 128;
142 pub const WSAPROTOCOL_LEN: DWORD = 255;
143 pub const INVALID_SOCKET: SOCKET = !0;
145 pub const MAX_PROTOCOL_CHAIN: DWORD = 7;
147 pub const MAXIMUM_REPARSE_DATA_BUFFER_SIZE: usize = 16 * 1024;
148 pub const FSCTL_GET_REPARSE_POINT: DWORD = 0x900a8;
149 pub const IO_REPARSE_TAG_SYMLINK: DWORD = 0xa000000c;
150 pub const IO_REPARSE_TAG_MOUNT_POINT: DWORD = 0xa0000003;
151 pub const SYMLINK_FLAG_RELATIVE: DWORD = 0x00000001;
152 pub const FSCTL_SET_REPARSE_POINT: DWORD = 0x900a4;
154 pub const SYMBOLIC_LINK_FLAG_DIRECTORY: DWORD = 0x1;
155 pub const SYMBOLIC_LINK_FLAG_ALLOW_UNPRIVILEGED_CREATE: DWORD = 0x2;
157 // Note that these are not actually HANDLEs, just values to pass to GetStdHandle
158 pub const STD_INPUT_HANDLE: DWORD = -10i32 as DWORD;
159 pub const STD_OUTPUT_HANDLE: DWORD = -11i32 as DWORD;
160 pub const STD_ERROR_HANDLE: DWORD = -12i32 as DWORD;
162 pub const PROGRESS_CONTINUE: DWORD = 0;
164 pub const E_NOTIMPL: HRESULT = 0x80004001u32 as HRESULT;
166 pub const INVALID_HANDLE_VALUE: HANDLE = !0 as HANDLE;
168 pub const FACILITY_NT_BIT: DWORD = 0x1000_0000;
170 pub const FORMAT_MESSAGE_FROM_SYSTEM: DWORD = 0x00001000;
171 pub const FORMAT_MESSAGE_FROM_HMODULE: DWORD = 0x00000800;
172 pub const FORMAT_MESSAGE_IGNORE_INSERTS: DWORD = 0x00000200;
174 pub const TLS_OUT_OF_INDEXES: DWORD = 0xFFFFFFFF;
176 pub const DLL_THREAD_DETACH: DWORD = 3;
177 pub const DLL_PROCESS_DETACH: DWORD = 0;
179 pub const INFINITE: DWORD = !0;
181 pub const DUPLICATE_SAME_ACCESS: DWORD = 0x00000002;
183 pub const CONDITION_VARIABLE_INIT: CONDITION_VARIABLE = CONDITION_VARIABLE { ptr: ptr::null_mut() };
184 pub const SRWLOCK_INIT: SRWLOCK = SRWLOCK { ptr: ptr::null_mut() };
186 pub const DETACHED_PROCESS: DWORD = 0x00000008;
187 pub const CREATE_NEW_PROCESS_GROUP: DWORD = 0x00000200;
188 pub const CREATE_UNICODE_ENVIRONMENT: DWORD = 0x00000400;
189 pub const STARTF_USESTDHANDLES: DWORD = 0x00000100;
191 pub const AF_INET: c_int = 2;
192 pub const AF_INET6: c_int = 23;
193 pub const SD_BOTH: c_int = 2;
194 pub const SD_RECEIVE: c_int = 0;
195 pub const SD_SEND: c_int = 1;
196 pub const SOCK_DGRAM: c_int = 2;
197 pub const SOCK_STREAM: c_int = 1;
198 pub const SOCKET_ERROR: c_int = -1;
199 pub const SOL_SOCKET: c_int = 0xffff;
200 pub const SO_RCVTIMEO: c_int = 0x1006;
201 pub const SO_SNDTIMEO: c_int = 0x1005;
202 pub const IPPROTO_IP: c_int = 0;
203 pub const IPPROTO_TCP: c_int = 6;
204 pub const IPPROTO_IPV6: c_int = 41;
205 pub const TCP_NODELAY: c_int = 0x0001;
206 pub const IP_TTL: c_int = 4;
207 pub const IPV6_V6ONLY: c_int = 27;
208 pub const SO_ERROR: c_int = 0x1007;
209 pub const SO_BROADCAST: c_int = 0x0020;
210 pub const IP_MULTICAST_LOOP: c_int = 11;
211 pub const IPV6_MULTICAST_LOOP: c_int = 11;
212 pub const IP_MULTICAST_TTL: c_int = 10;
213 pub const IP_ADD_MEMBERSHIP: c_int = 12;
214 pub const IP_DROP_MEMBERSHIP: c_int = 13;
215 pub const IPV6_ADD_MEMBERSHIP: c_int = 12;
216 pub const IPV6_DROP_MEMBERSHIP: c_int = 13;
217 pub const MSG_PEEK: c_int = 0x2;
221 pub imr_multiaddr: in_addr,
222 pub imr_interface: in_addr,
226 pub struct ipv6_mreq {
227 pub ipv6mr_multiaddr: in6_addr,
228 pub ipv6mr_interface: c_uint,
231 pub const VOLUME_NAME_DOS: DWORD = 0x0;
232 pub const MOVEFILE_REPLACE_EXISTING: DWORD = 1;
234 pub const FILE_BEGIN: DWORD = 0;
235 pub const FILE_CURRENT: DWORD = 1;
236 pub const FILE_END: DWORD = 2;
238 pub const WAIT_OBJECT_0: DWORD = 0x00000000;
239 pub const WAIT_TIMEOUT: DWORD = 258;
240 pub const WAIT_FAILED: DWORD = 0xFFFFFFFF;
242 pub const PIPE_ACCESS_INBOUND: DWORD = 0x00000001;
243 pub const PIPE_ACCESS_OUTBOUND: DWORD = 0x00000002;
244 pub const FILE_FLAG_FIRST_PIPE_INSTANCE: DWORD = 0x00080000;
245 pub const FILE_FLAG_OVERLAPPED: DWORD = 0x40000000;
246 pub const PIPE_WAIT: DWORD = 0x00000000;
247 pub const PIPE_TYPE_BYTE: DWORD = 0x00000000;
248 pub const PIPE_REJECT_REMOTE_CLIENTS: DWORD = 0x00000008;
249 pub const PIPE_READMODE_BYTE: DWORD = 0x00000000;
251 pub const FD_SETSIZE: usize = 64;
253 pub const STACK_SIZE_PARAM_IS_A_RESERVATION: DWORD = 0x00010000;
255 pub const STATUS_SUCCESS: NTSTATUS = 0x00000000;
258 #[cfg(not(target_pointer_width = "64"))]
261 pub wHighVersion: WORD,
262 pub szDescription: [u8; WSADESCRIPTION_LEN + 1],
263 pub szSystemStatus: [u8; WSASYS_STATUS_LEN + 1],
264 pub iMaxSockets: u16,
266 pub lpVendorInfo: *mut u8,
269 #[cfg(target_pointer_width = "64")]
272 pub wHighVersion: WORD,
273 pub iMaxSockets: u16,
275 pub lpVendorInfo: *mut u8,
276 pub szDescription: [u8; WSADESCRIPTION_LEN + 1],
277 pub szSystemStatus: [u8; WSASYS_STATUS_LEN + 1],
280 #[derive(Copy, Clone)]
288 pub struct WSAPROTOCOL_INFO {
289 pub dwServiceFlags1: DWORD,
290 pub dwServiceFlags2: DWORD,
291 pub dwServiceFlags3: DWORD,
292 pub dwServiceFlags4: DWORD,
293 pub dwProviderFlags: DWORD,
294 pub ProviderId: GUID,
295 pub dwCatalogEntryId: DWORD,
296 pub ProtocolChain: WSAPROTOCOLCHAIN,
298 pub iAddressFamily: c_int,
299 pub iMaxSockAddr: c_int,
300 pub iMinSockAddr: c_int,
301 pub iSocketType: c_int,
302 pub iProtocol: c_int,
303 pub iProtocolMaxOffset: c_int,
304 pub iNetworkByteOrder: c_int,
305 pub iSecurityScheme: c_int,
306 pub dwMessageSize: DWORD,
307 pub dwProviderReserved: DWORD,
308 pub szProtocol: [u16; (WSAPROTOCOL_LEN as usize) + 1],
312 #[derive(Copy, Clone)]
313 pub struct WIN32_FILE_ATTRIBUTE_DATA {
314 pub dwFileAttributes: DWORD,
315 pub ftCreationTime: FILETIME,
316 pub ftLastAccessTime: FILETIME,
317 pub ftLastWriteTime: FILETIME,
318 pub nFileSizeHigh: DWORD,
319 pub nFileSizeLow: DWORD,
323 #[allow(dead_code)] // we only use some variants
324 pub enum FILE_INFO_BY_HANDLE_CLASS {
326 FileStandardInfo = 1,
329 FileDispositionInfo = 4,
330 FileAllocationInfo = 5,
331 FileEndOfFileInfo = 6,
333 FileCompressionInfo = 8,
334 FileAttributeTagInfo = 9,
335 FileIdBothDirectoryInfo = 10, // 0xA
336 FileIdBothDirectoryRestartInfo = 11, // 0xB
337 FileIoPriorityHintInfo = 12, // 0xC
338 FileRemoteProtocolInfo = 13, // 0xD
339 FileFullDirectoryInfo = 14, // 0xE
340 FileFullDirectoryRestartInfo = 15, // 0xF
341 FileStorageInfo = 16, // 0x10
342 FileAlignmentInfo = 17, // 0x11
343 FileIdInfo = 18, // 0x12
344 FileIdExtdDirectoryInfo = 19, // 0x13
345 FileIdExtdDirectoryRestartInfo = 20, // 0x14
346 MaximumFileInfoByHandlesClass,
350 pub struct FILE_BASIC_INFO {
351 pub CreationTime: LARGE_INTEGER,
352 pub LastAccessTime: LARGE_INTEGER,
353 pub LastWriteTime: LARGE_INTEGER,
354 pub ChangeTime: LARGE_INTEGER,
355 pub FileAttributes: DWORD,
359 pub struct FILE_END_OF_FILE_INFO {
360 pub EndOfFile: LARGE_INTEGER,
364 pub struct REPARSE_DATA_BUFFER {
365 pub ReparseTag: c_uint,
366 pub ReparseDataLength: c_ushort,
367 pub Reserved: c_ushort,
372 pub struct SYMBOLIC_LINK_REPARSE_BUFFER {
373 pub SubstituteNameOffset: c_ushort,
374 pub SubstituteNameLength: c_ushort,
375 pub PrintNameOffset: c_ushort,
376 pub PrintNameLength: c_ushort,
378 pub PathBuffer: WCHAR,
382 pub struct MOUNT_POINT_REPARSE_BUFFER {
383 pub SubstituteNameOffset: c_ushort,
384 pub SubstituteNameLength: c_ushort,
385 pub PrintNameOffset: c_ushort,
386 pub PrintNameLength: c_ushort,
387 pub PathBuffer: WCHAR,
390 pub type LPPROGRESS_ROUTINE = crate::option::Option<
391 unsafe extern "system" fn(
392 TotalFileSize: LARGE_INTEGER,
393 TotalBytesTransferred: LARGE_INTEGER,
394 StreamSize: LARGE_INTEGER,
395 StreamBytesTransferred: LARGE_INTEGER,
396 dwStreamNumber: DWORD,
397 dwCallbackReason: DWORD,
399 hDestinationFile: HANDLE,
405 pub struct CONDITION_VARIABLE {
413 pub struct CRITICAL_SECTION {
414 CriticalSectionDebug: LPVOID,
416 RecursionCount: LONG,
417 OwningThread: HANDLE,
418 LockSemaphore: HANDLE,
419 SpinCount: ULONG_PTR,
423 pub struct REPARSE_MOUNTPOINT_DATA_BUFFER {
424 pub ReparseTag: DWORD,
425 pub ReparseDataLength: DWORD,
427 pub ReparseTargetLength: WORD,
428 pub ReparseTargetMaximumLength: WORD,
430 pub ReparseTarget: WCHAR,
438 pub Data4: [BYTE; 8],
442 pub struct WSAPROTOCOLCHAIN {
444 pub ChainEntries: [DWORD; MAX_PROTOCOL_CHAIN as usize],
448 pub struct SECURITY_ATTRIBUTES {
450 pub lpSecurityDescriptor: LPVOID,
451 pub bInheritHandle: BOOL,
455 pub struct PROCESS_INFORMATION {
456 pub hProcess: HANDLE,
458 pub dwProcessId: DWORD,
459 pub dwThreadId: DWORD,
463 pub struct STARTUPINFO {
465 pub lpReserved: LPWSTR,
466 pub lpDesktop: LPWSTR,
472 pub dwXCountChars: DWORD,
473 pub dwYCountCharts: DWORD,
474 pub dwFillAttribute: DWORD,
476 pub wShowWindow: WORD,
477 pub cbReserved2: WORD,
478 pub lpReserved2: LPBYTE,
479 pub hStdInput: HANDLE,
480 pub hStdOutput: HANDLE,
481 pub hStdError: HANDLE,
485 pub struct SOCKADDR {
486 pub sa_family: ADDRESS_FAMILY,
487 pub sa_data: [CHAR; 14],
491 #[derive(Copy, Clone)]
492 pub struct FILETIME {
493 pub dwLowDateTime: DWORD,
494 pub dwHighDateTime: DWORD,
498 pub struct SYSTEM_INFO {
499 pub wProcessorArchitecture: WORD,
501 pub dwPageSize: DWORD,
502 pub lpMinimumApplicationAddress: LPVOID,
503 pub lpMaximumApplicationAddress: LPVOID,
504 pub dwActiveProcessorMask: DWORD_PTR,
505 pub dwNumberOfProcessors: DWORD,
506 pub dwProcessorType: DWORD,
507 pub dwAllocationGranularity: DWORD,
508 pub wProcessorLevel: WORD,
509 pub wProcessorRevision: WORD,
513 pub struct OVERLAPPED {
514 pub Internal: *mut c_ulong,
515 pub InternalHigh: *mut c_ulong,
517 pub OffsetHigh: DWORD,
522 #[allow(dead_code)] // we only use some variants
523 pub enum ADDRESS_MODE {
531 pub struct SOCKADDR_STORAGE_LH {
532 pub ss_family: ADDRESS_FAMILY,
533 pub __ss_pad1: [CHAR; 6],
535 pub __ss_pad2: [CHAR; 112],
539 pub struct ADDRINFOA {
541 pub ai_family: c_int,
542 pub ai_socktype: c_int,
543 pub ai_protocol: c_int,
544 pub ai_addrlen: size_t,
545 pub ai_canonname: *mut c_char,
546 pub ai_addr: *mut SOCKADDR,
547 pub ai_next: *mut ADDRINFOA,
551 #[derive(Copy, Clone)]
552 pub struct sockaddr_in {
553 pub sin_family: ADDRESS_FAMILY,
554 pub sin_port: USHORT,
555 pub sin_addr: in_addr,
556 pub sin_zero: [CHAR; 8],
560 #[derive(Copy, Clone)]
561 pub struct sockaddr_in6 {
562 pub sin6_family: ADDRESS_FAMILY,
563 pub sin6_port: USHORT,
564 pub sin6_flowinfo: c_ulong,
565 pub sin6_addr: in6_addr,
566 pub sin6_scope_id: c_ulong,
570 #[derive(Copy, Clone)]
576 #[derive(Copy, Clone)]
577 pub struct in6_addr {
578 pub s6_addr: [u8; 16],
582 #[derive(Copy, Clone)]
583 #[allow(dead_code)] // we only use some variants
584 pub enum EXCEPTION_DISPOSITION {
585 ExceptionContinueExecution,
586 ExceptionContinueSearch,
587 ExceptionNestedException,
588 ExceptionCollidedUnwind,
594 pub fd_count: c_uint,
595 pub fd_array: [SOCKET; FD_SETSIZE],
598 impl Clone for fd_set {
599 fn clone(&self) -> fd_set {
605 #[derive(Copy, Clone)]
611 // Desktop specific functions & types
613 if #[cfg(not(target_vendor = "uwp"))] {
614 pub const EXCEPTION_CONTINUE_SEARCH: LONG = 0;
615 pub const EXCEPTION_STACK_OVERFLOW: DWORD = 0xc00000fd;
616 pub const EXCEPTION_MAXIMUM_PARAMETERS: usize = 15;
619 pub struct EXCEPTION_RECORD {
620 pub ExceptionCode: DWORD,
621 pub ExceptionFlags: DWORD,
622 pub ExceptionRecord: *mut EXCEPTION_RECORD,
623 pub ExceptionAddress: LPVOID,
624 pub NumberParameters: DWORD,
625 pub ExceptionInformation: [LPVOID; EXCEPTION_MAXIMUM_PARAMETERS],
631 pub struct EXCEPTION_POINTERS {
632 pub ExceptionRecord: *mut EXCEPTION_RECORD,
633 pub ContextRecord: *mut CONTEXT,
636 pub type PVECTORED_EXCEPTION_HANDLER =
637 extern "system" fn(ExceptionInfo: *mut EXCEPTION_POINTERS) -> LONG;
640 #[derive(Copy, Clone)]
641 pub struct CONSOLE_READCONSOLE_CONTROL {
643 pub nInitialChars: ULONG,
644 pub dwCtrlWakeupMask: ULONG,
645 pub dwControlKeyState: ULONG,
648 pub type PCONSOLE_READCONSOLE_CONTROL = *mut CONSOLE_READCONSOLE_CONTROL;
651 pub struct BY_HANDLE_FILE_INFORMATION {
652 pub dwFileAttributes: DWORD,
653 pub ftCreationTime: FILETIME,
654 pub ftLastAccessTime: FILETIME,
655 pub ftLastWriteTime: FILETIME,
656 pub dwVolumeSerialNumber: DWORD,
657 pub nFileSizeHigh: DWORD,
658 pub nFileSizeLow: DWORD,
659 pub nNumberOfLinks: DWORD,
660 pub nFileIndexHigh: DWORD,
661 pub nFileIndexLow: DWORD,
664 pub type LPBY_HANDLE_FILE_INFORMATION = *mut BY_HANDLE_FILE_INFORMATION;
665 pub type LPCVOID = *const c_void;
667 pub const HANDLE_FLAG_INHERIT: DWORD = 0x00000001;
669 pub const TOKEN_READ: DWORD = 0x20008;
671 #[link(name = "advapi32")]
673 // Forbidden when targeting UWP
674 #[link_name = "SystemFunction036"]
675 pub fn RtlGenRandom(RandomBuffer: *mut u8, RandomBufferLength: ULONG) -> BOOLEAN;
677 // Allowed but unused by UWP
678 pub fn OpenProcessToken(
679 ProcessHandle: HANDLE,
680 DesiredAccess: DWORD,
681 TokenHandle: *mut HANDLE,
685 #[link(name = "userenv")]
687 // Allowed but unused by UWP
688 pub fn GetUserProfileDirectoryW(
690 lpProfileDir: LPWSTR,
691 lpcchSize: *mut DWORD,
695 #[link(name = "kernel32")]
697 // Functions forbidden when targeting UWP
699 hConsoleInput: HANDLE,
701 nNumberOfCharsToRead: DWORD,
702 lpNumberOfCharsRead: LPDWORD,
703 pInputControl: PCONSOLE_READCONSOLE_CONTROL,
706 pub fn WriteConsoleW(
707 hConsoleOutput: HANDLE,
709 nNumberOfCharsToWrite: DWORD,
710 lpNumberOfCharsWritten: LPDWORD,
714 pub fn GetConsoleMode(hConsoleHandle: HANDLE, lpMode: LPDWORD) -> BOOL;
715 // Allowed but unused by UWP
716 pub fn GetFileInformationByHandle(
718 lpFileInformation: LPBY_HANDLE_FILE_INFORMATION,
720 pub fn SetHandleInformation(hObject: HANDLE, dwMask: DWORD, dwFlags: DWORD) -> BOOL;
721 pub fn AddVectoredExceptionHandler(
723 VectoredHandler: PVECTORED_EXCEPTION_HANDLER,
725 pub fn CreateHardLinkW(
726 lpSymlinkFileName: LPCWSTR,
727 lpTargetFileName: LPCWSTR,
728 lpSecurityAttributes: LPSECURITY_ATTRIBUTES,
730 pub fn SetThreadStackGuarantee(_size: *mut c_ulong) -> BOOL;
735 // UWP specific functions & types
737 if #[cfg(target_vendor = "uwp")] {
738 pub const BCRYPT_USE_SYSTEM_PREFERRED_RNG: DWORD = 0x00000002;
741 pub struct FILE_STANDARD_INFO {
742 pub AllocationSize: LARGE_INTEGER,
743 pub EndOfFile: LARGE_INTEGER,
744 pub NumberOfLinks: DWORD,
745 pub DeletePending: BOOLEAN,
746 pub Directory: BOOLEAN,
749 #[link(name = "bcrypt")]
751 pub fn BCryptGenRandom(
758 #[link(name = "kernel32")]
760 pub fn GetFileInformationByHandleEx(
762 fileInfoClass: FILE_INFO_BY_HANDLE_CLASS,
763 lpFileInformation: LPVOID,
770 // Shared between Desktop & UWP
772 #[link(name = "kernel32")]
774 pub fn GetCurrentProcessId() -> DWORD;
775 pub fn InitializeCriticalSection(CriticalSection: *mut CRITICAL_SECTION);
776 pub fn EnterCriticalSection(CriticalSection: *mut CRITICAL_SECTION);
777 pub fn TryEnterCriticalSection(CriticalSection: *mut CRITICAL_SECTION) -> BOOL;
778 pub fn LeaveCriticalSection(CriticalSection: *mut CRITICAL_SECTION);
779 pub fn DeleteCriticalSection(CriticalSection: *mut CRITICAL_SECTION);
781 pub fn RemoveDirectoryW(lpPathName: LPCWSTR) -> BOOL;
782 pub fn SetFileAttributesW(lpFileName: LPCWSTR, dwFileAttributes: DWORD) -> BOOL;
783 pub fn SetLastError(dwErrCode: DWORD);
784 pub fn GetCommandLineW() -> *mut LPCWSTR;
785 pub fn GetTempPathW(nBufferLength: DWORD, lpBuffer: LPCWSTR) -> DWORD;
786 pub fn GetCurrentProcess() -> HANDLE;
787 pub fn GetCurrentThread() -> HANDLE;
788 pub fn GetStdHandle(which: DWORD) -> HANDLE;
789 pub fn ExitProcess(uExitCode: c_uint) -> !;
790 pub fn DeviceIoControl(
792 dwIoControlCode: DWORD,
794 nInBufferSize: DWORD,
796 nOutBufferSize: DWORD,
797 lpBytesReturned: LPDWORD,
798 lpOverlapped: LPOVERLAPPED,
801 lpThreadAttributes: LPSECURITY_ATTRIBUTES,
803 lpStartAddress: extern "system" fn(*mut c_void) -> DWORD,
805 dwCreationFlags: DWORD,
808 pub fn WaitForSingleObject(hHandle: HANDLE, dwMilliseconds: DWORD) -> DWORD;
809 pub fn SwitchToThread() -> BOOL;
810 pub fn Sleep(dwMilliseconds: DWORD);
811 pub fn GetProcessId(handle: HANDLE) -> DWORD;
813 lpExistingFileName: LPCWSTR,
814 lpNewFileName: LPCWSTR,
815 lpProgressRoutine: LPPROGRESS_ROUTINE,
820 pub fn FormatMessageW(
829 pub fn TlsAlloc() -> DWORD;
830 pub fn TlsGetValue(dwTlsIndex: DWORD) -> LPVOID;
831 pub fn TlsSetValue(dwTlsIndex: DWORD, lpTlsvalue: LPVOID) -> BOOL;
832 pub fn GetLastError() -> DWORD;
833 pub fn QueryPerformanceFrequency(lpFrequency: *mut LARGE_INTEGER) -> BOOL;
834 pub fn QueryPerformanceCounter(lpPerformanceCount: *mut LARGE_INTEGER) -> BOOL;
835 pub fn GetExitCodeProcess(hProcess: HANDLE, lpExitCode: LPDWORD) -> BOOL;
836 pub fn TerminateProcess(hProcess: HANDLE, uExitCode: UINT) -> BOOL;
837 pub fn CreateProcessW(
838 lpApplicationName: LPCWSTR,
839 lpCommandLine: LPWSTR,
840 lpProcessAttributes: LPSECURITY_ATTRIBUTES,
841 lpThreadAttributes: LPSECURITY_ATTRIBUTES,
842 bInheritHandles: BOOL,
843 dwCreationFlags: DWORD,
844 lpEnvironment: LPVOID,
845 lpCurrentDirectory: LPCWSTR,
846 lpStartupInfo: LPSTARTUPINFO,
847 lpProcessInformation: LPPROCESS_INFORMATION,
849 pub fn GetEnvironmentVariableW(n: LPCWSTR, v: LPWSTR, nsize: DWORD) -> DWORD;
850 pub fn SetEnvironmentVariableW(n: LPCWSTR, v: LPCWSTR) -> BOOL;
851 pub fn GetEnvironmentStringsW() -> LPWCH;
852 pub fn FreeEnvironmentStringsW(env_ptr: LPWCH) -> BOOL;
853 pub fn GetModuleFileNameW(hModule: HMODULE, lpFilename: LPWSTR, nSize: DWORD) -> DWORD;
854 pub fn CreateDirectoryW(
856 lpSecurityAttributes: LPSECURITY_ATTRIBUTES,
858 pub fn DeleteFileW(lpPathName: LPCWSTR) -> BOOL;
859 pub fn GetCurrentDirectoryW(nBufferLength: DWORD, lpBuffer: LPWSTR) -> DWORD;
860 pub fn SetCurrentDirectoryW(lpPathName: LPCWSTR) -> BOOL;
861 pub fn DuplicateHandle(
862 hSourceProcessHandle: HANDLE,
863 hSourceHandle: HANDLE,
864 hTargetProcessHandle: HANDLE,
865 lpTargetHandle: LPHANDLE,
866 dwDesiredAccess: DWORD,
867 bInheritHandle: BOOL,
873 nNumberOfBytesToRead: DWORD,
874 lpNumberOfBytesRead: LPDWORD,
875 lpOverlapped: LPOVERLAPPED,
880 nNumberOfBytesToWrite: DWORD,
881 lpNumberOfBytesWritten: LPDWORD,
882 lpOverlapped: LPOVERLAPPED,
884 pub fn CloseHandle(hObject: HANDLE) -> BOOL;
885 pub fn MoveFileExW(lpExistingFileName: LPCWSTR, lpNewFileName: LPCWSTR, dwFlags: DWORD)
887 pub fn SetFilePointerEx(
889 liDistanceToMove: LARGE_INTEGER,
890 lpNewFilePointer: PLARGE_INTEGER,
893 pub fn FlushFileBuffers(hFile: HANDLE) -> BOOL;
896 dwDesiredAccess: DWORD,
898 lpSecurityAttributes: LPSECURITY_ATTRIBUTES,
899 dwCreationDisposition: DWORD,
900 dwFlagsAndAttributes: DWORD,
901 hTemplateFile: HANDLE,
904 pub fn FindFirstFileW(fileName: LPCWSTR, findFileData: LPWIN32_FIND_DATAW) -> HANDLE;
905 pub fn FindNextFileW(findFile: HANDLE, findFileData: LPWIN32_FIND_DATAW) -> BOOL;
906 pub fn FindClose(findFile: HANDLE) -> BOOL;
908 pub fn GetProcAddress(handle: HMODULE, name: LPCSTR) -> *mut c_void;
909 pub fn GetModuleHandleA(lpModuleName: LPCSTR) -> HMODULE;
910 pub fn GetModuleHandleW(lpModuleName: LPCWSTR) -> HMODULE;
912 pub fn GetSystemTimeAsFileTime(lpSystemTimeAsFileTime: LPFILETIME);
913 pub fn GetSystemInfo(lpSystemInfo: LPSYSTEM_INFO);
916 lpEventAttributes: LPSECURITY_ATTRIBUTES,
921 pub fn WaitForMultipleObjects(
923 lpHandles: *const HANDLE,
925 dwMilliseconds: DWORD,
927 pub fn CreateNamedPipeW(
931 nMaxInstances: DWORD,
932 nOutBufferSize: DWORD,
933 nInBufferSize: DWORD,
934 nDefaultTimeOut: DWORD,
935 lpSecurityAttributes: LPSECURITY_ATTRIBUTES,
937 pub fn CancelIo(handle: HANDLE) -> BOOL;
938 pub fn GetOverlappedResult(
940 lpOverlapped: LPOVERLAPPED,
941 lpNumberOfBytesTransferred: LPDWORD,
944 pub fn CreateSymbolicLinkW(
945 lpSymlinkFileName: LPCWSTR,
946 lpTargetFileName: LPCWSTR,
949 pub fn GetFinalPathNameByHandleW(
951 lpszFilePath: LPCWSTR,
955 pub fn SetFileInformationByHandle(
957 FileInformationClass: FILE_INFO_BY_HANDLE_CLASS,
958 lpFileInformation: LPVOID,
961 pub fn SleepConditionVariableSRW(
962 ConditionVariable: PCONDITION_VARIABLE,
964 dwMilliseconds: DWORD,
968 pub fn WakeConditionVariable(ConditionVariable: PCONDITION_VARIABLE);
969 pub fn WakeAllConditionVariable(ConditionVariable: PCONDITION_VARIABLE);
971 pub fn AcquireSRWLockExclusive(SRWLock: PSRWLOCK);
972 pub fn AcquireSRWLockShared(SRWLock: PSRWLOCK);
973 pub fn ReleaseSRWLockExclusive(SRWLock: PSRWLOCK);
974 pub fn ReleaseSRWLockShared(SRWLock: PSRWLOCK);
975 pub fn TryAcquireSRWLockExclusive(SRWLock: PSRWLOCK) -> BOOLEAN;
976 pub fn TryAcquireSRWLockShared(SRWLock: PSRWLOCK) -> BOOLEAN;
978 pub fn CompareStringOrdinal(
987 #[link(name = "ws2_32")]
989 pub fn WSAStartup(wVersionRequested: WORD, lpWSAData: LPWSADATA) -> c_int;
990 pub fn WSACleanup() -> c_int;
991 pub fn WSAGetLastError() -> c_int;
992 pub fn WSADuplicateSocketW(
995 lpProtocolInfo: LPWSAPROTOCOL_INFO,
1000 dwBufferCount: DWORD,
1001 lpNumberOfBytesSent: LPDWORD,
1003 lpOverlapped: LPWSAOVERLAPPED,
1004 lpCompletionRoutine: LPWSAOVERLAPPED_COMPLETION_ROUTINE,
1008 lpBuffers: LPWSABUF,
1009 dwBufferCount: DWORD,
1010 lpNumberOfBytesRecvd: LPDWORD,
1012 lpOverlapped: LPWSAOVERLAPPED,
1013 lpCompletionRoutine: LPWSAOVERLAPPED_COMPLETION_ROUTINE,
1019 lpProtocolInfo: LPWSAPROTOCOL_INFO,
1023 pub fn ioctlsocket(s: SOCKET, cmd: c_long, argp: *mut c_ulong) -> c_int;
1024 pub fn closesocket(socket: SOCKET) -> c_int;
1025 pub fn recv(socket: SOCKET, buf: *mut c_void, len: c_int, flags: c_int) -> c_int;
1026 pub fn send(socket: SOCKET, buf: *const c_void, len: c_int, flags: c_int) -> c_int;
1032 addr: *mut SOCKADDR,
1033 addrlen: *mut c_int,
1040 addr: *const SOCKADDR,
1043 pub fn shutdown(socket: SOCKET, how: c_int) -> c_int;
1044 pub fn accept(socket: SOCKET, address: *mut SOCKADDR, address_len: *mut c_int) -> SOCKET;
1049 optval: *mut c_char,
1056 optval: *const c_void,
1059 pub fn getsockname(socket: SOCKET, address: *mut SOCKADDR, address_len: *mut c_int) -> c_int;
1060 pub fn getpeername(socket: SOCKET, address: *mut SOCKADDR, address_len: *mut c_int) -> c_int;
1061 pub fn bind(socket: SOCKET, address: *const SOCKADDR, address_len: socklen_t) -> c_int;
1062 pub fn listen(socket: SOCKET, backlog: c_int) -> c_int;
1063 pub fn connect(socket: SOCKET, address: *const SOCKADDR, len: c_int) -> c_int;
1065 node: *const c_char,
1066 service: *const c_char,
1067 hints: *const ADDRINFOA,
1068 res: *mut *mut ADDRINFOA,
1070 pub fn freeaddrinfo(res: *mut ADDRINFOA);
1073 readfds: *mut fd_set,
1074 writefds: *mut fd_set,
1075 exceptfds: *mut fd_set,
1076 timeout: *const timeval,
1080 // Functions that aren't available on every version of Windows that we support,
1081 // but we still use them and just provide some form of a fallback implementation.
1086 // https://docs.microsoft.com/en-us/windows/win32/api/processthreadsapi/nf-processthreadsapi-setthreaddescription
1087 pub fn SetThreadDescription(hThread: HANDLE,
1088 lpThreadDescription: LPCWSTR) -> HRESULT {
1089 SetLastError(ERROR_CALL_NOT_IMPLEMENTED as DWORD); E_NOTIMPL
1092 // >= Win8 / Server 2012
1093 // https://docs.microsoft.com/en-us/windows/win32/api/sysinfoapi/nf-sysinfoapi-getsystemtimepreciseasfiletime
1094 pub fn GetSystemTimePreciseAsFileTime(lpSystemTimeAsFileTime: LPFILETIME)
1096 GetSystemTimeAsFileTime(lpSystemTimeAsFileTime)
1101 "api-ms-win-core-synch-l1-2-0":
1103 // >= Windows 8 / Server 2012
1104 // https://docs.microsoft.com/en-us/windows/win32/api/synchapi/nf-synchapi-waitonaddress
1105 pub fn WaitOnAddress(
1107 CompareAddress: LPVOID,
1108 AddressSize: SIZE_T,
1109 dwMilliseconds: DWORD
1111 panic!("WaitOnAddress not available")
1113 pub fn WakeByAddressSingle(Address: LPVOID) -> () {
1114 // If this api is unavailable, there cannot be anything waiting, because
1115 // WaitOnAddress would've panicked. So it's fine to do nothing here.
1121 pub fn NtCreateKeyedEvent(
1122 KeyedEventHandle: LPHANDLE,
1123 DesiredAccess: ACCESS_MASK,
1124 ObjectAttributes: LPVOID,
1127 panic!("keyed events not available")
1129 pub fn NtReleaseKeyedEvent(
1130 EventHandle: HANDLE,
1133 Timeout: PLARGE_INTEGER
1135 panic!("keyed events not available")
1137 pub fn NtWaitForKeyedEvent(
1138 EventHandle: HANDLE,
1141 Timeout: PLARGE_INTEGER
1143 panic!("keyed events not available")