<Return[WXYZ]><Top>

WNetConnectionDialog

Declare Function Api_WNetConnectionDialog& Lib "mpr" Alias "WNetConnectionDialog" (ByVal hWnd&, ByVal dwType&)

Declare Function WNetConnectionDialog Lib "mpr" (ByVal hWnd As Long, ByVal dwType As Long) As Long

ネットワーク資源に接続するための汎用の参照ダイアログボックスを起動する。この関数は、そのダイアログボックスを所有するウィンドウのハンドルを必要とする。

パラメータ
hwnd
［入力］ダイアログボックスを所有するウィンドウのハンドルを指定する。
dwType
［入力］接続対象となる資源の種類を指定します。次の値を指定する。

    値                                      

意味                                                                                                                   

    RESOURCETYPE_DISK

ディスク資源に接続する。


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

    値                                                     

意味                                                                                                                   

    ERROR_EXTENDED_ERROR

　

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

    ERROR_INVALID_PASSWORD

指定したパスワードが無効である。

    ERROR_NO_NETWORK

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

    ERROR_NOT_ENOUGH_MEMORY

ダイアログボックスを起動するための十分なメモリがない。

　

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

    行われる。
    この関数が接続を試み、ネットワークプロバイダが ERROR_INVALID_PASSWORD メッセージを返した場合、システムはユーザーにパスワ

    ードの入力を求める。システムは新しいパスワードを使って、もう一度接続を試みる。