WlanDisconnect

インターフェイスを現在のネットワークから切断する。

WlanDisconnect hClientHandle, pInterfaceGuid, pReserved

hClientHandle : [intptr] WlanOpenHandle の以前の呼び出しで取得したクライアントのセッション ハンドル。
pInterfaceGuid : [var] 切断するインターフェイスの GUID。
pReserved : [intptr] 将来の使用のために予約されている。NULL を設定する必要がある。

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

解説

インターフェイスを現在のネットワークから切断する。

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

[備考]
WlanConnect で接続を確立した際に指定されたプロファイルがすべてのユーザー用プロファイルの場合、WlanDisconnect
の呼び出し元はそのプロファイルに対する実行アクセス権が必要で、そうでなければ ERROR_ACCESS_DENIED
で失敗する。コマンドラインからは netsh wlan disconnect を使う。Windows XP SP3 および Windows
XP SP2 用 API: WlanDisconnect にはプロファイルをオンデマンド
プロファイルに変更するという副作用がある。オンデマンド プロファイルのネットワークには Wireless Zero
Configuration サービスが自動接続しない。プロファイルをオンデマンドに変更したい場合以外は、WlanConnect
の前に呼ぶべきではない。WlanConnect で接続を確立すると既存接続は自動的に切断される。

情報