WlanSetProfile

特定プロファイルの内容を設定する。

WlanSetProfile hClientHandle, pInterfaceGuid, dwFlags, strProfileXml, strAllUserProfileSecurity, bOverwrite, pReserved, pdwReasonCode

hClientHandle : [intptr] WlanOpenHandle の以前の呼び出しで取得したクライアントのセッション ハンドル。
pInterfaceGuid : [var] インターフェイスの GUID。
dwFlags : [int] プロファイルに設定するフラグ。Windows XP SP3 および XP SP2 用 API: 0 でなければならず、ユーザー別プロファイルは未対応。
strProfileXml : [wstr] プロファイルの XML 表現。ルート要素は WLANProfile。サンプルは Wireless Profile Samples を参照。最大長は定義されていない。Windows XP SP3 および XP SP2 用 API: 互換条件を満たす必要がある。
strAllUserProfileSecurity : [wstr] すべてのユーザー用プロファイルのセキュリティ記述子文字列を設定する。dwFlags が WLAN_PROFILE_USER なら無視。新規作成時に NULL なら wlan_secure_add_new_all_user_profiles のセキュリティ記述子が使われる。既存プロファイルに NULL ならアクセス権は変更されない。Windows XP SP3 および XP SP2 用 API: NULL でなければならない。
bOverwrite : [int] 既存プロファイルを上書きするか。FALSE で既存なら上書きされずエラーが返る。
pReserved : [intptr] 将来の使用のために予約されている。NULL を設定する必要がある。
pdwReasonCode : [var] プロファイルが無効な理由を示す WLAN_REASON_CODE 値。

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

解説

特定プロファイルの内容を設定する。

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

[備考]
WlanSetProfile は新規 WLAN プロファイル追加または既存置換に使用する。新プロファイルはグループ
ポリシーの後のリスト先頭に追加される。既存上書きの場合は順序は保持される。平文鍵 (protected=FALSE)
を含むプロファイルも設定可能で、ストア保存時に自動暗号化される。WlanGetProfile
取得時は暗号化済み鍵が返る。すべてのユーザー用プロファイルには読み取り、書き込み、実行の 3
種のアクセス権がある。セキュリティ記述子オブジェクトの作成および文字列化の手順を以下に示す。
このドキュメントは省略されている。

情報