<Return[MN]><Top>

NetWkstaUserSetInfo

Declare Function Api_NetWkstaUserSetInfo& Lib "netapi32" Alias "NetWkstaUserSetInfo" (ByRef Reserved&, ByVal level&, ByVal buf$, ByRef parm_err&)

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

ワークステーションの構成要素のうち、ユーザー固有の情報を設定する。
    セキュリティの要件:この関数は、ローカルコンピュータ上でのみ機能する。

パラメータ
reserved
    NULL を指定する。
level
    データの情報レベルを指定する。このパラメータは、次の値のいずれかである。

    値     

意味                                                                                                                                                               

    1

 

現在のユーザーの名前と、このワークステーションからアクセスしている(アクセス先の)ドメインなど、ワークステーションに関する情報を指定する。buf パラメータが指すバッファで、1 個の 構造体を指定する。

    1101

ワークステーションのブラウズ先のドメインを指定する。buf パラメータが指すバッファで、1 個の 構造体を指定する。

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

    ラメータの値によって異なる。このバッファはシステムによって割り当てられたものであり、NetApiBufferFree 関数を使って解放しなければな

    らない。
parm_err
    1 つの DWORD 値へのポインタを指定する。ERROR_INVALID_PARAMETER エラーが生じた場合、この値に、情報構造体の中でエラ

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

    納されない。

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

    値                                                     

意味                                                                    

    ERROR_INVALID_LEVEL

level パラメータが無効である。

    ERROR_INVALID_PARAMETER

関数パラメータのいずれかが無効である。