Функция NetGroupSetInfo (lmaccess.h)
Функция NetGroupSetInfo задает параметры глобальной группы в базе данных безопасности, которая является базой данных диспетчера учетных записей безопасности (SAM) или, в случае контроллеров домена, Active Directory.
Синтаксис
NET_API_STATUS NET_API_FUNCTION NetGroupSetInfo(
[in] LPCWSTR servername,
[in] LPCWSTR groupname,
[in] DWORD level,
[in] LPBYTE buf,
[out] LPDWORD parm_err
);
Параметры
[in] servername
Указатель на константную строку, указывающую DNS- или NetBIOS-имя удаленного сервера, на котором выполняется функция. Если этот параметр имеет значение NULL, используется локальный компьютер.
[in] groupname
Указатель на константную строку, указывающую имя глобальной группы, для которой задаются сведения. Дополнительные сведения см. в разделе "Примечания".
[in] level
Указывает уровень информации о данных. Этот параметр может принимать одно из указанных ниже значений.
Значение | Значение |
---|---|
|
Указывает имя глобальной группы. Параметр buf указывает на структуру GROUP_INFO_0 . |
|
Указывает имя глобальной группы и комментарий. Параметр buf указывает на структуру GROUP_INFO_1 . |
|
Указывает подробные сведения о глобальной группе. Параметр buf указывает на структуру GROUP_INFO_2 . Обратите внимание, что в Windows XP и более поздних версиях рекомендуется использовать GROUP_INFO_3 . |
|
Указывает подробные сведения о глобальной группе. Параметр buf указывает на структуру GROUP_INFO_3 .
Windows 2000: Этот уровень не поддерживается. |
|
Указывает комментарий только о глобальной группе. Параметр buf указывает на структуру GROUP_INFO_1002 . |
|
Задает глобальные атрибуты группы. Параметр buf указывает на структуру GROUP_INFO_1005 . |
Дополнительные сведения см. в разделе "Примечания".
[in] buf
Указатель на буфер, содержащий данные. Формат этих данных зависит от значения параметра level . Дополнительные сведения см. в разделе Буферы функций управления сетью.
[out] parm_err
Указатель на значение, которое получает индекс первого члена информационной структуры группы по ошибке после ERROR_INVALID_PARAMETER кода ошибки. Если этот параметр имеет значение NULL, индекс не возвращается при ошибке. Дополнительные сведения см. в разделе "Примечания".
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет NERR_Success.
Если функция завершается сбоем, возвращаемое значение может быть одним из следующих кодов ошибок.
Код возврата | Описание |
---|---|
|
У пользователя нет доступа к запрошенной информации. |
|
Один из параметров функции недопустим. Дополнительные сведения см. в разделе "Примечания". |
|
Недопустимое имя компьютера. |
|
Операция разрешена только на основном контроллере домена. |
|
Не удалось найти имя глобальной группы. |
|
Операция не допускается в определенных специальных группах. К этим группам относятся группы пользователей, группы администраторов, локальные и гостевые группы. |
Комментарии
При программировании для Active Directory вы можете вызвать определенные методы интерфейса службы Active Directory (ADSI) для достижения тех же функциональных возможностей, которые можно достичь, вызывая функции группы управления сетью. Дополнительные сведения см. в разделе IADsGroup.
Если вы вызываете эту функцию на контроллере домена под управлением Active Directory, доступ разрешен или запрещен на основе списка управления доступом (ACL) для защищаемого объекта. ACL по умолчанию разрешает вызывать эту функцию только администраторам домена и операторам учетных записей. На рядовом сервере или рабочей станции эту функцию могут вызывать только администраторы и опытные пользователи. Дополнительные сведения см. в разделе Требования к безопасности для функций управления сетью. Дополнительные сведения о списках управления доступом, ACE и маркерах доступа см. в разделе модель контроль доступа.
Дескриптор безопасности объекта Group используется для выполнения проверка доступа для этой функции. Как правило, вызывающие объекты должны иметь доступ на запись ко всему объекту для успешного выполнения вызовов этой функции.
Правильный способ задать новое имя глобальной группы — вызвать функцию NetGroupSetInfo , используя структуру GROUP_INFO_0 . Укажите новое значение в элементе grpi0_name . Если вы используете структуру GROUP_INFO_1 и указываете значение в элементе grpi1_name , новое значение имени игнорируется.
Если функция NetGroupSetInfo возвращает ERROR_INVALID_PARAMETER, можно использовать параметр parm_err , чтобы указать, что первый недопустимый член информационной структуры группы. (Структура сведений о группе начинается с GROUP_INFO_ и ее формат задается параметром уровня .) В следующей таблице перечислены значения, которые могут быть возвращены в параметре parm_err , и соответствующий элемент структуры, который находится в ошибке. (Префикс grpi*_ указывает, что элемент может начинаться с нескольких префиксов, например grpi1_ или grpi2_.)
Значение | Член |
---|---|
GROUP_NAME_PARMNUM | grpi*_name |
GROUP_COMMENT_PARMNUM | grpi*_comment |
GROUP_ATTRIBUTES_PARMNUM | grpi*_attributes |
Имена учетных записей пользователей ограничены 20 символами, а имена групп — 256 символами. Кроме того, имена учетных записей не могут быть завершены точкой и не могут содержать запятые или какие-либо из следующих печатных символов: ", /, , [, ], :, |, <, >, +, =, ;, ?, *. Имена также не могут содержать символы в диапазоне от 1 до 31, которые не могут быть печатными.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | lmaccess.h (включая Lm.h) |
Библиотека | Netapi32.lib |
DLL | Netapi32.dll |