Zig 0.17.0-dev (Split by item) This is an example of documentation generated by
ZigDoc , an alternative to Zig's built-in
Auto Doc feature. See also
examples in other modes/formats . The project being documented here (as the example) is the Zig standard library.
std › Io › Threaded › netConnectIpWindows Private Function netConnectIpWindows Doc Source Private Function std.Io.Threaded.netConnectIpWindows
fn netConnectIpWindows (
userdata : ?*anyopaque ,
address : *const IpAddress ,
options : IpAddress .ConnectOptions ,
) IpAddress .ConnectError !net .Socket Params File Io/Threaded.zig: 12371
12371
12372
12373
12374
12375
12376
12377
12378
12379
12380
12381
12382
12383
12384
12385
12386
12387
12388
12389
12390
12391
12392
12393
12394
12395
12396
12397
12398
12399
12400
12401
12402
12403
12404
12405
12406 fn netConnectIpWindows (
userdata : ?*anyopaque ,
address : *const IpAddress ,
options : IpAddress .ConnectOptions ,
) IpAddress .ConnectError !net .Socket {
if (!have_networking ) return error .NetworkDown ;
if (options .timeout != .none ) @panic ("TODO implement netConnectIpWindows with timeout" );
const t : *Threaded = @ptrCast (@alignCast (userdata ));
_ = t ;
const family = posixAddressFamily (address );
const socket_handle = try openSocketAfd (family , .{ .mode = options .mode , .protocol = options .protocol });
errdefer windows .CloseHandle (socket_handle );
try setSocketOptionAfd (socket_handle , ws2_32 .SOL .SOCKET , ws2_32 .SO .REUSE_UNICASTPORT , true );
const bound_address = bindSocketIpAfd (socket_handle , &switch (address .*) {
.ip4 => .{ .ip4 = .unspecified (0 ) },
.ip6 => .{ .ip6 = .unspecified (0 ) },
}, .Active ) catch |err | switch (err ) {
error .AddressInUse => return error .Unexpected ,
else => |e | return e ,
};
const Storage = extern struct { Reserved0 : [3 ]usize = @splat (0 ), Address : PosixAddress };
var storage : Storage = .{ .Address = undefined };
const addr_len = addressToPosix (address , &storage .Address );
switch ((try deviceIoControl (&.{
.file = .{ .handle = socket_handle , .flags = .{ .nonblocking = true } },
.code = windows .IOCTL .AFD .CONNECT ,
.in = @as ([]const u8 , @ptrCast (&storage ))[0 .. @offsetOf (Storage , "Address" ) + addr_len ],
})).u .Status ) {
.SUCCESS => {},
.CANCELLED => unreachable ,
.INSUFFICIENT_RESOURCES => return error .SystemResources ,
.CONNECTION_REFUSED => return error .ConnectionRefused ,
else => |status | return windows .unexpectedStatus (status ),
}
return .{ .handle = socket_handle , .address = bound_address };
}