<Return[MN]><Top>

NetShareAdd

Declare Function Api_NetShareAdd& Lib "netapi32" Alias "NetShareAdd" (ByVal servername$, ByVal level&, ByVal buf$, ByRef parm_err&)

Declare Function NetShareAdd Lib "netapi32" Alias "NetShareAdd" (ByVal servername As String, ByVal level As Long, ByVal buf As String, ByRef parm_err As Long) As Long

サーバーリソースを共有する。

パラメータ
servername
    この関数を実行するリモートサーバーの名前を表す、Unicode（Windows NT/2000）または ANSI（Windows 95/98）文字列へのポイン

    タを指定する。この文字列の先頭は "\\" でなければならない。このパラメータで NULL を指定すると、ローカルコンピュータが使われる。
level
    データの情報レベルを指定する。次の値のいずれかを指定する。
    Windows NT/2000：次のレベルが有効である。

    値     

意味                                                                                                                      

    2

　

リソースの名前、タイプ、アクセス許可、接続の数など、共有リソースに関する情報を指定する。buf パラメータが指すバッファで、1 個の 構造体を指定する。

    502

　

リソースの名前、タイプ、アクセス許可、接続の数、他の固有情報など、共有リソースに関する情報を指定する。buf パラメータが指すバッファで、1 個の 構造体を指定する

    Windows 95/98：次のレベルが有効である。

    値     

意味                                                                                                                      

    50

　

リソースの名前とタイプ、リソースに関連付けられているコメント、パスワードなど、共有リソースに関する情報を指定する。pbBuffer パラメータが指すバッファで、1 個の 構造体を指定する。

buf
    1 個のバッファへのポインタを指定する。関数から制御が返ると、このバッファに、指定したデータが格納される。このデータの形式は、level

    パラメータの値によって異なる。
parm_err
    1 つの DWORD 値へのポインタを指定する。ERROR_INVALID_PARAMETER エラーが生じた場合、この値に、共有情報構造体の中

    でエラーを生じさせた最初のメンバを表すインデックス番号が格納される。このパラメータで NULL を指定すると、エラーが生じてもインデック

    ス番号は格納されない。

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

    値                                                

意味                                                                          

    ERROR_ACCESS_DENIED

ユーザーには、要求した情報へのアクセス権がない。

    ERROR_INVALID_LEVEL

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

    ERROR_INVALID_NAME

文字またはファイルシステム名が無効である。

    ERROR_INVALID_PARAMETER

指定されたパラメータは無効である。

    NERR_DuplicateShare

指定した共有名は、既にこのサーバーで使われている。

    NERR_RedirectedPath

リダイレクトされたリソースに対して、この操作は無効である。指定されたデバイス名は、共有リソースに割り当てられている。

    NERR_UnknownDevDir

デバイスまたはディレクトリが存在しない。