Windows のプログラミングのネタです。
最近、お仕事で必要になり、今更ながら Study したのですが、これ関連のキーワードを検索しても日本語の情報が少なかったので、この機会に書き留めておきます。
開発環境： Visual Studio 2005 (Visual Studio 8)
開発言語： C
対象OS： Windows XP SP3
Embedded な仕事が多いので、C++ ではなく、C がメインです。
◆ Native WiFi API 概要 (Wireless LAN API)
PC にワイヤレスのネットワークアダプタをつけていると、ワイヤレスネットワーク接続 というメニューが使えて、SSID のリストを更新したり、接続／切断 といった操作が可能になりますが、それらをネイティブなプログラム言語から簡単に操作できるようにしたもの。
※ UWSC 使ってラクしてたんだけど、XPスタイルだったり、クラシックだったり、[スタート]メニューのオプション差異だったりで、対応が大変なことになったので、Native WiFi を使うことにしました。
Native Wifi (Windows) -- MSDNNative WiFi API は、Windows XP SP3 以降から対応 との事なんですが、それは Wlanapi.dll が（System32 の中に）入ってます．．．という事らしいです。
http://msdn.microsoft.com/en-us/library/ms706556%28VS.85%29.aspx
開発するには、Wlanapi.lib, Wlanapi.h が必要です。
◆Windows SDK 6.0 のインストール
ワシの環境 (VS8) には、Wlanapi 関連のファイル(.lib/.h) はありませんでした。最新の Windows SDK （旧：Platform SDK） に含まれているらしいです。
早速ダウンロード。
Windows SDK 6.0 (EN)MS の英語サイトからでも、日本語サイトからでもダウンロード可能。日本語サイトだとバージョン表示が 1.0 とかになってるけど、ファイル名をみると 6.2.600... とかなので OK のようです。ワシは、日本語サイトからダウンロードしました。Vista とか言ってるけど、XP に入れて良いものです。
http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=4377f86d-c913-4b5c-b87e-ef72e5b4e065
Windows Vista および .NET Framework 3.0 ランタイム コンポーネント用 Microsoft Windows Software Development Kit
http://www.microsoft.com/downloads/details.aspx?FamilyID=7614fe22-8a64-4dfb-aa0c-db53035f40a0&DisplayLang=ja
※ MS のサイトはすぐにデッドリンクになるので、困ったら [Windows SDK] で検索してみてください。
ダウンロードしたファイルは、CD/DVD のイメージファイル(*.img) なので、仮想CD/DVDドライブソフト（DAEMON Tools Lite など）でイメージをマウント。インストールウィザードに従いインストールを完了させます。
インストールの途中、HDD のアクセスランプが点きっぱなしになり、プログレスバーが固まった．．．ように見える時がありますが、そこは耐えて待ってください。CPU: Core2 Duo 2.4GHz/HDD: SATA2 （会社PC）なんですが、インストールの終わる気配が無いので、何度キャンセルボタンを押しそうになったか．．．。しかし、
◆環境設定
Windows SDK は、下記のフォルダにインストールされたハズ。
- C:\Program Files\Microsoft SDKs\Windows\v6.0\
また、Native WiFi のプログラムを書く場合は、上記フォルダ配下から、Wlanapi.lib, Wlanapi.h を（Native WiFi API を利用したい）自分のプロジェクトのフォルダへコピーして来ます。
プロジェクトを立ち上げ（Visual Studio 2005 起動）、プロジェクトのプロファイルを修正します。
「C/C++/全般/追加のインクルードディレクトリ」に Windows SDK の Include フォルダを指定し、パスを通します。自分のプロジェクトの Native WiFi API を利用するモジュールで、以下の宣言を追加
C:\Program Files\Microsoft SDKs\Windows\v6.0\Include
「リンカ/入力/追加の依存ファイル」 に wlanapi.lib を追加します。
#define WIN32_LEAN_AND_MEAN
#include <stdio.h>
#include <windows.h>
#include <winnt.h>
#include "wlanapi.h"
．．．と、これでコンパイルが通るハズ。プロジェクト全体に WIN32_LEAN_AND_MEAN を適用すると問題がでる場合もあるかも。Wlanapi を使うモジュール内でのみの宣言が吉。
◆使用する
API 利用のサンプルコードは、Windows SDK のインストールフォルダ階層に含まれてます。
Native Wifi API Sample
C:\Program Files\Microsoft SDKs\Windows\v6.0\Samples\NetDs\Wlan
追記：適当なネットワークに接続するコードを書いてみました。
blogger にソースコードを貼り付けるテストも兼ねて。
//-------------------------------------------------------------------------
//
// Native WiFi API 関連
//
//-------------------------------------------------------------------------
#define WIN32_LEAN_AND_MEAN
#include <stdio.h>
#include <windows.h>
#include <winnt.h>
#include "wlanapi.h"
//-------------------------------------------------------------------------
// ワイヤレスネットワークに接続する
//
BOOL ConnetWirelessLAN(void)
{
HANDLE hWLAN = NULL;
PWLAN_INTERFACE_INFO_LIST pInterfaceList = NULL;
DWORD dwNicCount;
DWORD dwVersion;
BOOL retCode = FALSE;
// WLAN ハンドル取得
if(WlanOpenHandle(WLAN_API_MAKE_VERSION(1, 0), NULL, &dwVersion, &hWLAN) != ERROR_SUCCESS){
return FALSE;
}
// NIC リスト取得
if(WlanEnumInterfaces(hWLAN, NULL, &pInterfaceList) != ERROR_SUCCESS){
WlanCloseHandle(hWLAN, NULL);
return FALSE;
}
// NIC 列挙
for(dwNicCount=0; dwNicCount < pInterfaceList->dwNumberOfItems; dwNicCount++){
PWLAN_AVAILABLE_NETWORK_LIST pAvailableNetworkList;
GUID* pGuid;
pGuid = &pInterfaceList->InterfaceInfo[dwNicCount].InterfaceGuid;
//使用可能なネットワークリストの取得
if(WlanGetAvailableNetworkList(hWLAN, pGuid, 0, NULL, &pAvailableNetworkList) == ERROR_SUCCESS){
DWORD dwAvailableCount;
//見つけたネットワークに対して順に接続を試みる
for(dwAvailableCount=0; dwAvailableCount < pAvailableNetworkList->dwNumberOfItems; dwAvailableCount++){
PWLAN_AVAILABLE_NETWORK pAvailableNetwork = &pAvailableNetworkList->Network[dwAvailableCount];
WLAN_CONNECTION_PARAMETERS wlanConnectionParams;
//接続パラメータ
ZeroMemory(&wlanConnectionParams, sizeof(WLAN_CONNECTION_PARAMETERS));
wlanConnectionParams.wlanConnectionMode = wlan_connection_mode_profile;
wlanConnectionParams.strProfile = pAvailableNetwork->strProfileName;
wlanConnectionParams.pDot11Ssid = &pAvailableNetwork->dot11Ssid;
wlanConnectionParams.pDesiredBssidList = NULL;
wlanConnectionParams.dot11BssType = pAvailableNetwork->dot11BssType;
wlanConnectionParams.dwFlags = 0;
//接続
if(WlanConnect(hWLAN, pGuid, &wlanConnectionParams, NULL) == ERROR_SUCCESS){
retCode = TRUE;
break;
}
}
WlanFreeMemory(pAvailableNetworkList);
}
}
WlanFreeMemory(pInterfaceList);
WlanCloseHandle(hWLAN, NULL);
return retCode;
}
ソースコードをBloggerに貼り付けるための変換（"<, >"記号をタグとして認識させないようにするとか）には、クリボウさんのコンバータを利用させて頂きました。
有用なToolの提供、有難うございます。
クリボウの Blogger Tips: コードをハイライトする「Code Prettify」ウィジェット
