NAME Win32::Wlan - Query wlan properties SYNOPSIS require Win32::Wlan; my $wlan = Win32::Wlan->new; if ($wlan->available) { print "Connected to ", $wlan->connection->{profile_name},"\n"; print "I see the following networks\n"; for ($wlan->visible_networks) { printf "%s\t-%d dbm\n", $_->{name}, $_->{signal_quality}; }; } else { print "No Wlan detected (or switched off)\n"; }; METHODS `Win32::Wlan->new( %args )' my $wlan = Win32::Wlan->new(); Creates a new Win32::Wlan object. * `available' - optional argument to force detection of general Wlan availability * `handle' - optional argument to give an existing Wlan handle to the object * `interface' - optional argument to give an existing guuid to the object `$wlan->handle' Returns the Windows API handle for the Wlan API. `$wlan->interface' print $wlan->interface->{name}; Returns a hashref describing the interface. The keys are `guuid' for the guuid, `name' for the human-readable name and `status' for the status of the interface. `$wlan->available' $wlan->available or warn "Wlan API is not available"; Returns whether the Wlan API is available. The Wlan API is available on Windows XP SP3 or higher. `$wlan->connected' $wlan->connected or warn "Wlan connection unavailable"; Returns whether a Wlan connection is established. No connection is established when Wlan is switched off or no access point is in range. `$wlan->connection' if ($wlan->connected) { print "Connected to "; print $wlan->connection->{profile_name}; }; Returns information about the current connection in a hashref. The keys are * `profile_name' - the name of the profile of the current connection `$wlan->visible_networks' Returns information about the currently visible networks as a list of hashrefs. * `ssid' - the SSID of the network * `signal_quality' - the signal quality ranging linearly from 0 to 100 meaning -100 dbm to -50 dbm SIMPLIFICATIONS This module only supports the first wireless connection. If your machine has more than one wireless connection, you will need to use Win32::Wlan::API directly. Currently, the module also has no way of determining whether Wlan gets switched on or off. SEE ALSO Win32::Wlan::API - the wrapper for the Windows API Windows Native Wifi Reference http://msdn.microsoft.com/en-us/library/ms706274%28v=VS.85%29.aspx REPOSITORY The public repository of this module is http://github.com/Corion/Win32-Wlan. SUPPORT The public support forum of this module is http://perlmonks.org/. BUG TRACKER Please report bugs in this module via the RT CPAN bug queue at https://rt.cpan.org/Public/Dist/Display.html?Name=Win32-Wlan or via mail to win32-wlan-Bugs@rt.cpan.org. AUTHOR Max Maischein `corion@cpan.org' COPYRIGHT (c) Copyright 2011-2011 by Max Maischein `corion@cpan.org'. LICENSE This module is released under the same terms as Perl itself.