На главную

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 | Скачать Вниз

NetGroupAdd



The NetGroupAdd function creates a global group in the security database.

Security Requirements

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

NET_API_STATUS NetGroupAdd(

LPWSTR servername,
DWORD level,
LPBYTE buf,
LPDWORD parm_err
);


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.

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 buf parameter contains a pointer to a GROUP_INFO_0 structure.
1 Specify group name and a comment. The buf parameter contains a pointer to a GROUP_INFO_1 structure.
2 Specifies information about the group. The buf parameter contains a pointer to a GROUP_INFO_2 structure.


buf

Pointer to a buffer containing the global group information structure.

parm_err

Optional pointer to a DWORD to return the index of the first parameter in error when ERROR_INVALID_PARAMETER is returned. If NULL, the parameter is not returned on error.



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_GroupExists The group already exists.
NERR_NotPrimary The operation is allowed only on the primary domain controller of the domain.
ERROR_INVALID_LEVEL The value specified for the Level parameter is invalid.
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


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

NetGroupAdd



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

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

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

NET_API_STATUS NetGroupAdd(

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


Параметры

servername

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

уровень

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

Значение Величины
0 Определяют групповое имя. Параметр буфера содержит указатель в структуру GROUP_INFO_0.
1 Определяют групповое имя и комментарий. Параметр буфера содержит указатель в структуру GROUP_INFO_1.
2 Определяет информацию о группе. Параметр буфера содержит указатель в структуру GROUP_INFO_2.


буфер

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

parm_err

Дополнительный указатель на DWORD, чтобы возвращать индекс первого параметра ошибочно когда ERROR_INVALID_PARAMETER возвращан. Если НЕДЕЙСТВИТЕЛЬНО, параметр не возвращан на ошибку.



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

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

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


Смотри Также

NetGroupAddUser, NetGroupDel


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz