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 | Скачать

NetGroupSetUsers

The NetGroupSetUsers function sets the global group membership for the specified global group. Each user specified is made a member of the global group. Users that are not specified but are currently members of the global group will have their membership revoked.

One use of NetGroupSetUsers is to replace the current membership with an entirely new membership. The typical sequence is to use the NetGroupGetUsers function, modify the returned membership list to look the way you want it to be, then call NetGroupSetUsers.

Security Requirements

Only members of the Administrators or Account Operators local group can successfully execute NetGroupSetUsers on a remote server.

NET_API_STATUS NetGroupSetUsers(

LPWSTR servername,
LPWSTR groupname,
DWORD level,
LPBYTE buf,
DWORD NewMemberCount
);

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.

groupname

Pointer to a Unicode string containing the name of the global group to which the specified users belong.

level

Specifies one of the following values to set the level of information pointed to in the buf parameter.

Value Meaning
0 Specify group name. The specified buffer points to an array of GROUP_USERS_INFO_0 structures.
1 Specify group attributes. The specified buffer points to an array of GROUP_USERS_INFO_1 structures.

buf

Pointer to the buffer location of the designated data.

NewMemberCount

Specifies the number of entries in the buffer pointed to by buf.

Return Values

If the function succeeds, the return value is 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_NotPrimary The operation is allowed only on the primary domain controller of the domain.
NERR_GroupNotFound The group name could not be found.
NERR_UserNotFound The user name could not be found.
NERR_SpeGroupOp The operation is not allowed on specified special groups, which are user groups, admin groups, local groups, or guest groups.

See Also

NetGroupAddUser, NetGroupDel, NetGroupDelUser

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

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

NetGroupSetUsers

Функция NetGroupSetUsers устанавливает глобальное групповое членство для определенной глобальной группы. Каждый определенный потребитель сделан член глобальной группы. Потребители, что не определены но - к настоящему времени участники глобальной группы будут иметь их отмененное членство.

Один использование NetGroupSetUsers должно заменить текущее членство полностью новым членством. Типичная последовательность должна использовать функцию NetGroupGetUsers, модифицировать возвращанный список членства, чтобы смотреть в соответствии с вашими пожеланиями, чтобы быть затем называть NetGroupSetUsers.

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

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

NET_API_STATUS NetGroupSetUsers(

LPWSTR servername, LPWSTR groupname, УРОВЕНЬ DWORD, буфер LPBYTE, DWORD NewMemberCount
);

Параметры

servername

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

groupname

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

уровень

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

Значение Величины
0 Определяют групповое имя. Определенный буфер указывает на массив структур GROUP_USERS_INFO_0.
1 Определяют групповые атрибуты. Определенный буфер указывает на массив структур GROUP_USERS_INFO_1.

буфер

Указатель в буферную позицию определенных данных.

NewMemberCount

Определяет номер данных в буфере указанном, чтобы буфером.

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

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

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

Смотри Также

NetGroupAddUser, NetGroupDel, NetGroupDelUser

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