WlanGetProfile

指定されたワイヤレス プロファイルに関するすべての情報を取得する。

WlanGetProfile hClientHandle, pInterfaceGuid, strProfileName, pReserved, pstrProfileXml, pdwFlags, pdwGrantedAccess

hClientHandle : [intptr] WlanOpenHandle の以前の呼び出しで取得したクライアントのセッション ハンドル。
pInterfaceGuid : [var] ワイヤレス インターフェイスの GUID。GUID の一覧は WlanEnumInterfaces で取得できる。
strProfileName : [wstr] プロファイルの名前。大文字と小文字を区別。NULL 終端が必要。最大長は 255 文字 (終端含め 256)。Windows XP SP3 および XP SP2 用 API: 名前はネットワークの SSID から自動派生する。インフラストラクチャでは SSID、アドホックでは SSID + -adhoc。
pReserved : [intptr] 将来の使用のために予約されている。NULL を設定する必要がある。
pstrProfileXml : [var] 問い合わせ対象プロファイルの XML 表現を含む文字列。最大長は定義されていない。
pdwFlags : [var] 入力時は要求に関する追加情報を提供する変数へのポインタ。NULL の場合プロファイル フラグは返されない。出力時はプロファイル フラグを受け取る。Windows XP SP3 および Windows XP SP2 用 API: ユーザー別プロファイルは未対応のため NULL を設定。
pdwGrantedAccess : [var] すべてのユーザー用プロファイルのアクセス マスク。

(プラグイン / モジュール : wlanapi.dll)

解説

指定されたワイヤレス プロファイルに関するすべての情報を取得する。

[戻り値]
関数が成功すると、戻り値は ERROR_SUCCESS となる。関数が失敗した場合、戻り値は次のいずれかのコードとなりうる。
このドキュメントは省略されている。

[備考]
成功すると pstrProfileXml が指すバッファにプロファイルの XML 表現が返される。XML の詳細は
WLAN_profile Schema を参照。呼び出し元は不要になったら WlanFreeMemory
で解放する。すべてのユーザー用プロファイルの場合、呼び出し元はプロファイルに対する読み取りアクセス権が必要で、さもなくば
ERROR_ACCESS_DENIED で失敗する。Windows 7: 呼び出し時に pdwFlags に
WLAN_PROFILE_GET_PLAINTEXT_KEY フラグを指定すると keyMaterial
要素を平文で要求できる。平文鍵を取得するには wlan_secure_get_plaintext_key 権限が必要であり、DACL に
WLAN_READ_ACCESS を許可する ACE が必要である。既定では Administrators
のみ平文鍵の取得が許可される。権限がない場合は暗号化された鍵が返される (エラーはなし)。プロセスが LocalSystem
で動作している場合は CryptUnprotectData で復号できる。
Windows Server 2008 / Vista: keyMaterial は常に暗号化される。Windows XP SP3 および
XP SP2 用 API: 鍵は暗号化されない。

情報