<Return[WXYZ]><Top>

WNetAddConnection

Declare Function Api_WNetAddConnection& Lib "mpr" Alias "WNetAddConnectionA" (ByVal lpszNetPath$, ByVal lpszPassword$, ByVal lpszLocalName$)

Declare Function WNetAddConnection Lib "mpr" Alias "WNetAddConnectionA" (ByVal lpszNetPath As String, ByVal lpszPassword As String, ByVal lpszLocalName As String) As Long

ローカルデバイスをネットワーク資源に接続し、「恒久的な」接続を確立する。恒久的な接続は、以後のログオン時にシステムによって自動的に復元される。
注意 この関数は、16 ビット版 Windows との互換性のために提供されている。Win32 アプリケーションでは、WNetAddConnection2 または WNetAddConnection3 関数を使う。

パラメータ
lpRemoteName
    ［入力］接続先のネットワーク資源の名前を表す、NULL で終わる文字列へのポインタを指定する。
lpPassword
    ［入力］接続に使うパスワードを表す、NULL で終わる文字列へのポインタを指定する。通常は現在のユーザーのパスワードを使う。
    NULL を指定すると、既定のパスワードが使われる。空の文字列を指定すると、何もパスワードを使わない。
    Windows 95/98：NULL または空の文字列を指定する。
lpLocalName
    ［入力］"F:" または "LPT1" など、リダイレクトしたいローカルデバイスの名前を表す、NULL で終わる文字列へのポインタを指定する。大

    文字と小文字の区別はない。NULL を指定すると、ローカルデバイスのリダイレクトなしでネットワーク資源に接続する。

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

    値                                                                   

意味                                                                                                             

    ERROR_ACCESS_DENIED

アクセスが拒否された。

    ERROR_ALREADY_ASSIGNED

lpLocalName で指定したデバイスは既に接続されている。

    ERROR_BAD_DEV_TYPE

デバイスの種類と資源の種類が一致しない。

    ERROR_BAD_DEVICE

lpLocalName パラメータで指定した値が無効である。

    ERROR_BAD_NET_NAME

lpRemoteName パラメータで指定した値が無効か、指定した資源が見つからない。

    ERROR_BAD_PROFILE

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

    ERROR_CANNOT_OPEN_PROFILE

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

    ERROR_DEVICE_ALREADY_REMEMBERED

　

lpLocalName パラメータで指定したデバイスのエントリは既にユーザープロファイル内に存在する。

    ERROR_EXTENDED_ERROR

　

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

    ERROR_INVALID_PASSWORD

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

    ERROR_NO_NET_OR_BAD_PATH

　

ネットワークコンポーネントが開始されていないか、指定した名前が使えないため、操作を実行できない。

    ERROR_NO_NETWORK

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