<Return[WXYZ]><Top>

WNetGetProviderName

Declare Function Api_WNetGetProviderName& Lib "mpr" Alias "WNetGetProviderNameA" (ByVal dwNetType&, ByVal lpProvider$, lpBufferSize&)

Declare Function WNetGetProviderName Lib "mpr" Alias "WNetGetProviderNameA" (ByVal dwNetType As Long, ByVal lpProvider As String, lpBufferSize As Long) As Long

指定した種類のネットワークのプロバイダ名を取得する。

パラメータ
dwNetType
    [入力]希望のネットワークに固有のネットワークの種類を指定する。

    2つのネットワークが同じ種類になっている場合、この関数は最初にロードされたプロバイダの名前を返す。

    ネットワークの種類の上位ワードだけが使われる。ネットワーク側が下位ワードにサブタイプを返した場合でも、そのサブタイプは無視される。
    ヘッダーファイル WinNetwk.h 内で、ネットワークの種類の完全なリストを参照できる。
lpProviderName
    [出力]ネットワークプロバイダ名を受け取るバッファへのポインタを指定する。
lpBufferSize
    [入出力]この関数に渡したいバッファのサイズ( 文字数)を指定する。戻り値が ERROR_MORE_DATA の場合、lpBufferSize は、

    プロバイダ名を保持するために必要なバッファのサイズ( 文字数)を格納する。
    Windows 95/98:サイズは文字単位ではなく、バイト単位になる。また、バッファのサイズは少なくとも 1 バイトでなければならない。

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

    値                                             

意味                                                                                                

    ERROR_MORE_DATA

バッファサイズが小さすぎてネットワークプロバイダ名を格納できない。

    ERROR_NO_NETWORK

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

    ERROR_INVALID_ADDRESS

lpProviderName パラメータまたは lpBufferSize パラメータが無効である。