<Return[WXYZ]><Top>

WNetCancelConnection

Declare Function Api_WNetCancelConnection& Lib "mpr" Alias "WNetCancelConnectionA" (ByVal lpszName$, ByVal bForce&)

Declare Function WNetCancelConnection Lib "mpr" Alias "WNetCancelConnectionA" (ByVal lpszName As String, ByVal bForce As Long) As Long

既存のネットワーク接続を切断する。
この関数は、16 ビット版 Windows との互換性のために提供されている。Win32 アプリケーションでは、WNetCancelConnection2 関数を使う。

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

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

    指定すると、デバイスなしのリモートネットワークとの接続だけを切断する。
fForce
    [入力]接続上に開いているファイルやジョブが存在する場合でも切断を行うかどうか指定する。FALSE を指定した場合、開いているファ

    イルやジョブがあると関数は失敗する。

戻り値
    関数が成功すると、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 である。