<Return[WXYZ]><Top>

WNetDisconnectDialog1

Declare Function Api_WNetDisconnectDialog1& Lib "mpr" Alias "WNetDisconnectDialog1A" (ByRef lpConnDlgStruct As DISCDLGSTRUCTA)

Declare Function WNetDisconnectDialog1 Lib "mpr" Alias "WNetDisconnectDialog1A" (ByRef lpConnDlgStruct As DISCDLGSTRUCTA) As Long

ネットワーク資源からの切断を試みる。ネットワーク側から ERROR_OPEN_FILES が返された場合は、この関数はユーザーに確認のプロンプトを表示する。エラーが発生した場合は、この関数はユーザーにそのことを通知する。この関数は、切断の試みに関係するパラメータを指定するために、1 個の 構造体を必要とする。

パラメータ
lpConnDlgStruct
    ［入力］1 個の DISCDLGSTRUCT 構造体へのポインタを指定する。この構造体は切断の動作を指定する。


戻り値
    関数が成功すると、NO_ERROR が返る。ユーザーがダイアログボックスの［キャンセル］ボタンをクリックすると、-1 が返る。
    関数が失敗すると、次のいずれかのエラーコードが返る。

    値                                                       

意味                                                                                                                   

    ERROR_CANCELLED

切断するかどうかを決定するようプロンプトを表示したときに、ユーザーが切断を拒否した。

    ERROR_OPEN_FILES

ユーザーが接続をアクティブに使っているため、切断できない。

    ERROR_BUSY

ネットワークプロバイダがビジー(おそらく初期化中)である。この関数をもう一度呼び出す。

    ERROR_NO_NETWORK

ネットワークに接続されていない。

    ERROR_NOT_ENOUGH_MEMORY

メモリ不足のためダイアログが起動できない。

    ERROR_EXTENDED_ERROR

　

ネットワーク固有のエラーが発生した。 WNetGetLastError 関数を使って、エラーの説明を取得する。

　

解説
    ユーザーがダイアログボックスの［OK］をクリックすると、WNetDisconnectDialog 関数が制御を返すときに、要求したネットワーク接続の

    切断が行われる。