<Return[MN]><Top>

NetWkstaUserGetInfo

Declare Function Api_NetWkstaUserGetInfo& Lib "netapi32" Alias "NetWkstaUserGetInfo" (ByVal reserved&, ByVal Level&, bufptr As Any)

Declare Function NetWkstaUserGetInfo Lib "netapi32" (ByVal reserved As Long, ByVal Level As Long, bufptr As Any) As Long

現時点で既にログオンしているユーザーに関する情報を取得する。この関数は、既にログオンしているユーザーのコンテキストで実行しなければならない。
    セキュリティの要件：この関数は、ローカルコンピュータ上でのみ機能する。

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

    値     

意味                                                                                                                                                               

    0

　

現時点でワークステーションに既にログオンしているユーザーの名前を取得する。関数から制御が返ると、bufptr パラメータが指すバッファに、1 個の 構造体が返る。

    1

　

現在のユーザーの名前と、このワークステーションからアクセスしている（アクセス先の）ドメインなど、ワークステーションに関する情報を取得する。関数から制御が返ると、bufptr パラメータが指すバッファに、1 個の 構造体が格納される。

    1101

　

ワークステーションのブラウズ先のドメインを取得する。関数から制御が返ると、bufptr パラメータが指すバッファに、1 個の 構造体が格納される。

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

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

    ならない。

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

    値                                                     

意味                                                                    

    ERROR_NOT_ENOUGH_MEMORY

　

システムはメモリ資源を使い果たした。ネットワークマネージャによる構成が正しくないか、プログラムを実行しているシステムのメモリが不足している。

    ERROR_INVALID_LEVEL

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

    ERROR_INVALID_PARAMETER

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