<Return[WXYZ]><Top>

WNetGetConnection

Declare Function Api_WNetGetConnection& Lib "mpr" Alias "WNetGetConnectionA" (ByVal lpszLocalName$, ByVal lpszRemoteName$, cbRemoteName&)

Declare Function WNetGetConnection Lib "mpr" Alias "WNetGetConnectionA" (ByVal lpszLocalName As String, ByVal lpszRemoteName As String, cbRemoteName As Long) As Long

ローカル装置に対応するネットワーク資源の名前を取得する。

パラメータ
lpLocalName
    ネットワーク名が必要なローカル装置の名前を表す NULL で終わる文字列へのポインタを指定する。
lpRemoteName
    接続に使われているリモート名を表す NULL で終わる文字列を受け取るバッファへのポインタを指定する。
lpnLength
    lpRemoteName パラメータが指すバッファのサイズ( 文字数)が入った変数へのポインタを指定する。

    バッファのサイズが不十分で関数が失敗した場合は、必要なバッファサイズがこの変数に格納される。
 

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

    定数                                              

意味                                                                                                                     

    ERROR_BAD_DEVICE

lpLocalName パラメータが指す文字列が無効である。

    ERROR_NOT_CONNECTED

lpLocalName パラメータで指定した装置がリダイレクトされていない。

    ERROR_MORE_DATA

バッファのサイズが不十分である。lpnLength パラメータが指す変数に、必要なバッファサイズが格

納されている。この関数で取得可能なエントリが残っている。

    ERROR_CONNECTION_UNAVAIL

装置は現在接続されていないが、恒久的な接続として記憶されている。

    ERROR_NO_NETWORK

ネットワークにつながっていない。

    ERROR_EXTENDED_ERROR

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

使う。

    ERROR_NO_NET_OR_BAD_PATH

指定したローカル名を使った接続を認識するプロバイダがない。

その接続を使う1つ以上のプロバイダのネットワークにつながっていない可能性もある。