|
パラメータ
servername
この関数を実行するリモートサーバーの名前を表す、Unicode 文字列へのポインタを指定する。この文字列の先頭は "\\"
でなければならな
い。このパラメータが NULL の場合、ローカルコンピュータを表す。
username
情報を取得するべきユーザーアカウントの名前を表す、Unicode 文字列へのポインタを指定する。
level
データの情報レベルを指定する。このパラメータは、次の値のいずれかである。
|
値
|
意味
|
|
0 |
ユーザーアカウント名を取得する。関数から制御が返ると、bufptr
パラメータが指すバッファに、複数の 構造体からなる 1 つの配列が格納される。 |
|
1 |
ユーザーアカウントに関する情報を取得する。関数から制御が返ると、Bufptr
パラメータが指すバッファに、複数の 構造体からなる 1 つの配列が格納される。 |
|
2 |
レベル 1
の情報に加えて、ユーザーアカウントに関する追加の属性(アカウントの有効期間や利用可能なディスク領域など)を取得する。関数から制御が返ると、Bufptr
パラメータが指すバッファに、複数の 構造体からなる 1 つの配列が格納される。 |
|
3 |
レベル 2
の情報に加えて、ユーザーアカウントに関する追加の属性(プライマリグループやパスワードの有効期間など)を取得する。このレベルは、Windows
NT/2000 のサーバーでのみ有効です。関数から制御が返ると、Bufptr パラメータが指すバッファに、複数の 構造体からなる 1
つの配列が格納される。 |
|
10 |
ユーザー名とアカウント名、およびそれぞれに関連付けられているコメントを取得する。関数から制御が返ると、bufptr
パラメータが指すバッファに、複数の 構造体からなる 1 つの配列が格納される。 |
|
11 |
ユーザーアカウントに関する詳細な情報を取得する。関数から制御が返ると、bufptr パラメータが指すバッファに、複数の 構造体からなる 1
つの配列が格納される。 |
|
20 |
ユーザーの名前と識別子を取得する。関数から制御が返ると、bufptr
パラメータが指すバッファに、複数の 構造体からなる 1 つの配列が格納される。 |
bufptr
1
個のバッファへのポインタを指定する。関数から制御が返ると、このバッファに、指定したデータが格納される。このデータの形式は、level
パラメータの値によって異なる。このバッファはシステムによって割り当てられたものであり、NetApiBufferFree 関数を使って解放しなければ
ならない。
戻り値
関数が成功すると、NERR_Success が返る。
関数が失敗すると、次のエラーコードのいずれかが返る。
|
値
|
意味
|
|
ERROR_ACCESS_DENIED |
ユーザーには、要求した情報へのアクセス権がない。 |
|
NERR_InvalidComputer |
コンピュータ名が無効である。 |
|
NERR_UserNotFound |
指定されたユーザー名が見つからなかった。 |
|