<Return[WXYZ]><Top>

WNetCancelConnection2

Declare Function Api_WNetCancelConnection2& Lib "mpr" Alias "WNetCancelConnection2A" (ByVal lpName$, ByVal dwFlags&, ByVal fForce&)

Declare Function WNetCancelConnection2 Lib "mpr" Alias "WNetCancelConnection2A" (ByVal lpName As String, ByVal dwFlags As Long, ByVal fForce As Long) As Long

既存のネットワーク接続を切断する。また、記憶されているネットワーク接続で、現在接続が行われていないものを削除することもできる。
この関数は、WNetCancelConnection 関数に取って代わる。

パラメータ
lpName
    ［入力］リダイレクトされているローカルデバイス、または切断したいリモートネットワーク資源のどちらかの名前を表す、NULL で終わる文

    字列へのポインタを指定する。
    リダイレクトされているローカルデバイスを指定すると、この関数は指定したデバイスのリダイレクトだけを切断する。リモートネットワーク資源を

    指定すると、リモートネットワーク資源とのすべての接続を切断する。
dwFlags
    ［入力］接続の種類を示す 1 個の DWORD 値を指定する。次の値が定義されている。

    値                                                

意味                                                                                                                        

    0

　

　

接続に関する情報を更新しない。
レジストリに恒久的な接続として記憶されている接続は、次のログオン時に復元が試みられる。恒久的な接続として記憶されていない接続に対しては、CONNECT_UPDATE_PROFILE フラグの設定を無視する。

    CONNECT_UPDATE_PROFILE

　

　

ユーザープロファイルを「恒久的な接続でなくなった」という情報に更新する。
以後はログオン時に、その接続の復元を試みみない。(リモート名を使って資源を切断する場合、恒久的な接続には影響しない。)


戻り値
    関数が成功すると、NO_ERROR が返る。
    関数が失敗すると、次のいずれかのエラーコードが返る。

    値                                                      

意味                                                                                                                         

    ERROR_BAD_PROFILE

ユーザープロファイルの形式が正しくない。

    ERROR_CANNOT_OPEN_PROFILE

恒久的な接続を処理するためのユーザープロファイルを開くことができない。

    ERROR_DEVICE_IN_USE

指定したデバイスがアクティブなプロセスによって使用中のため、切断できない。

    ERROR_EXTENDED_ERROR

　

ネットワーク固有のエラーが発生した。エラーの説明を取得するには、WNetGetLastError

関数を使う。

    ERROR_NOT_CONNECTED

　

lpName パラメータで指定した名前がリダイレクトされているデバイスを表していないか、lpName

で指定したデバイスにシステムが接続していない。

    ERROR_OPEN_FILES

開いているファイルがあり、fForce が FALSE である。