Функции WinAPI - Компьютерленд

Главная » Функции WinAPI

Основные [1]

Системная функция NetUserEnum предоставляет информацию о зарегистрированных пользовательских аккаунтах на сервере (в системе). В зависимости от используемого уровня и фильтра получаемые данные о пользователях могут характеризоваться разным уровнем полноты.

Представление функции в .Net.

Функция NetUserEnum

На MSDN некоторые аргументы данной системной функции объясняются так:

servername — входящий параметр [in], представляет строку, описывающую DNS или NetBIOS имя удаленного сервера, на котором выполняется функция. Если данный параметр null, то функция выполняется на локальном компьютере.

level — входящий [in], описывает уровень получаемой информации о пользователе, он может приобретать значения 0, 1, 2, 3, 10, 11, 20, что связаны соответственно со структурами user_info_0, user_info_1, user_info_2, user_info_3, user_info_10, user_info_11, а последнее значение 20 связано с user_info_20 и user_info_23.

filter — входящий [in], описывает тип аккаунта пользователя, что будет включен в перечисление. Может принимать константные целочисленные значения:

const int FILTER_NORMAL_ACCOUNT	Перечисление типичных аккаунтов типичных пользователей.	0x0002
const int FILTER_TEMP_DUPLICATE_ACCOUNT	Получение данных о пользователе, учетка которого находится в другом домене.	0x0001
const int FILTER_INTERDOMAIN_TRUST_ACCOUNT		0x0008
const int FILTER_WORKSTATION_TRUST_ACCOUNT		0x0010
const int FILTER_SERVER_TRUST_ACCOUNT		0x0020

bufptr [out] — указатель на буфер, куда считываются данные о пользователях. Формат данного буфера зависит от используемого уровня.

prefmaxlen [in] — максимальная длина считываемых данных, используется const int MAX_PREFERRED_LENGTH = -1.

entriesread [out] — количество полученных элементов.

Возвращаемое значение функции описывается такими константами:

NERR_Success	Выполнение функции закончено успешно	0
NERR_Base		2100
NERR_InvalidComputer	Неподтвержденное имя компьютера	NERR_Base + 251

Пример:

public class UserWinAccounts
{
private const int FILTER_NORMAL_ACCOUNT = 0x0002;
private const int MAX_PREFERRED_LENGTH = -1;
private const int NERR_Success = 0;
private const int NERR_Base = 2100;
private const int NERR_InvalidComputer = NERR_Base + 251;
private static int EntriesRead;
private static int TotalEntries;
private static int Resume;
private static IntPtr bufPtr;
[DllImport("Netapi32.dll")]
private extern static int NetUserEnum(
[MarshalAs(UnmanagedType.LPWStr)] string servername,
int level,
int filter,
out IntPtr bufptr,
int prefmaxlen,
out int entriesread,
out int totalentries,
out int resume_handle
);
[DllImport("Netapi32.dll", SetLastError = true)]
private extern static int NetApiBufferFree(IntPtr Buffer);
public static List GetUsersWinAccounts()
{
List users = new List();
int res = NetUserEnum(null, 20, FILTER_NORMAL_ACCOUNT, out bufPtr, MAX_PREFERRED_LENGTH, out EntriesRead,
out TotalEntries, out Resume);
if (EntriesRead > 0)
{
IntPtr iter = bufPtr;
for (int i = 0; i < EntriesRead; i++)
{
User_Info_23 anuser = (User_Info_23)Marshal.PtrToStructure(iter, typeof(User_Info_23));
iter = (IntPtr)((int)iter + Marshal.SizeOf(typeof(User_Info_23)));
users.Add(anuser);
}
NetApiBufferFree(bufPtr);
}
return users;
}
}
}

Этот код позволяет получить данные об аккаунтах пользователей в операционной системе Windows. Те же данные можно получить из реестра, но только тогда, когда аккаунт хоть один раз использовался пользователем. Если же аккаунт существует, но пользователь ни одного раза не побывал в нем, значит нет и его сохраненных настроек в реестре, а потому единственно возможным способом получить данные обо всех аккаунтах на локальном компьютере, это низкоуровневые функции Windows, включая NetUserEnum.

В данном случае используется уровень 20 и структура User_Info_23 для получения информации о пользователях локального компьютера. Надо заметить, что в коде также получается встроенный сетевой аккаунт домашней группы "HomeGroupUser$".

Добавил: Иевенко Алексей (lesha)