On-line справка по Win32 API

БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!

A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать

NetUserGetLocalGroups

The NetUserGetLocalGroups function retrieves a list of local groups to which a specified user belongs.

Security Requirements

Only members of the Administrators or Account Operators local group can successfully execute NetUserGetLocalGroups.

NET_API_STATUS NetUserGetLocalGroups(

LPWSTR servername,
LPWSTR username,
DWORD level,
DWORD flags,
LPBYTE *bufptr,
DWORD prefmaxlen,
LPDWORD entriesread,
LPDWORD totalentries
);

Parameters

servername

Pointer to a Unicode string containing the name of the remote server on which the function is to execute. A NULL pointer or string specifies the local computer.

username

Pointer to a Unicode string containing the name of the user for which to return global group membership. This parameter can be of the form , in which case the username is expected to be found on servername. The user name can also be of the form \ in which case is associated with servername and is expected to be to be found on that domain.

level

Level of information required. Only 0 is valid.

flags

Bitmask of flags. Currently, only LG_INCLUDE_INDIRECT is defined. If this bit is set, the function will also return the local groups of which the user is indirectly a member (that is, by the virtue of being in a global group that itself is a member of one or more local groups).

bufptr

On return a pointer to the return information structure is returned in the address pointed to by bufptr. The returned information is an array of LOCALGROUP_USERS_INFO_0 structures. The returned buffer should be deallocated using the NetApiBufferFree function.

prefmaxlen

Preferred maximum length, in 8-bit bytes of returned data.

entriesread

Pointer to a DWORD that contains the actual enumerated element count.

totalentries

Pointer to a DWORD that contains the total number of entries that could have been enumerated.

Return Values

If the function is successful, it returns NERR_SUCCESS.
If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ACCESS_DENIED The user does not have access to the requested information.
NERR_InvalidComputer The computer name is invalid.
NERR_UserNotFound The user name could not be found.

See Also

NetApiBufferFree

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

NetUserGetLocalGroups

Функция NetUserGetLocalGroups извлекает список локальных групп на которых определенный потребитель принадлежит.

Требования Безопасности

Только участники Администраторов или локальной группы Учетных Операторов могут успешно выполнить NetUserGetLocalGroups.

NET_API_STATUS NetUserGetLocalGroups(

LPWSTR servername, ИМЯ пользователя LPWSTR, DWORD выравнивается, флаги DWORD, LPBYTE *bufptr, DWORD prefmaxlen, LPDWORD entriesread, totalentries LPDWORD
);

Параметры

servername

Указатель в строку Уникода, содержащую имя дистанционного сервера на котором функция должна выполняться. НЕДЕЙСТВИТЕЛЬНЫЙ указатель или строка определяет локальный компьютер.

имя пользователя

Указатель в строку Уникода, содержащую имя пользователя для которого, чтобы возвращать глобальное групповое членство. Этот параметр может быть формы , в этом случае ожидается, что имя пользователя будет обнаружено на servername. Имя пользователя может также быть формы \ в этом случае связан servername и ожидан, чтобы должно быть обнаружено в этой области.

уровень

Уровень информации требовался. Только 0 в силе.

флаги

Bitmask Флаги. К настоящему времени, только LG_INCLUDE_INDIRECT определен. Если этот бит установлен, функция также возвращает локальные группы из которых пользователь является косвенно элементом (то есть, достоинством в глобальной группе, что сам - элемент одной или более локальных групп).

bufptr

В возврате, указатель в обратную информационную структуру возвращан в адрес указанный, чтобы bufptr. Возвращанная информация является массивом структур LOCALGROUP_USERS_INFO_0. Возвращанный буфер должен быть освобожден используя функцию NetApiBufferFree.

prefmaxlen

Предпочтительная максимальная длина, в 8- битовых байтах возвращанных данных.

entriesread

Указатель на DWORD, которое содержит фактический перечисленный элементный счет.

totalentries

Указатель на DWORD, которое содержит общее число данных, что мочь перечислен.

Обратные Величины

Если функция имеет успех, она возвращает NERR_SUCCESS.
Если функция терпит неудачу, обратная величина - один из следующих кодов ошибки.

Значение Величины
ERROR_ACCESS_DENIED пользователь нет имеет доступ к запрошенной информации.
NERR_InvalidComputer компьютерное имя недействительно.
NERR_UserNotFound имя пользователя не могло обнаруживано.

Смотри Также

NetApiBufferFree

Используются технологии uCoz