Функция NetGroupSetInfo (lmaccess.h)

Статья
03/09/2023

Функция 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

Указывает уровень информации о данных. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
0	Указывает имя глобальной группы. Параметр buf указывает на структуру GROUP_INFO_0 .
1	Указывает имя глобальной группы и комментарий. Параметр buf указывает на структуру GROUP_INFO_1 .
2	Указывает подробные сведения о глобальной группе. Параметр buf указывает на структуру GROUP_INFO_2 . Обратите внимание, что в Windows XP и более поздних версиях рекомендуется использовать GROUP_INFO_3 .
3	Указывает подробные сведения о глобальной группе. Параметр buf указывает на структуру GROUP_INFO_3 . Windows 2000: Этот уровень не поддерживается.
1002	Указывает комментарий только о глобальной группе. Параметр buf указывает на структуру GROUP_INFO_1002 .
1005	Задает глобальные атрибуты группы. Параметр buf указывает на структуру GROUP_INFO_1005 .

Дополнительные сведения см. в разделе "Примечания".

[in] buf

Указатель на буфер, содержащий данные. Формат этих данных зависит от значения параметра level . Дополнительные сведения см. в разделе Буферы функций управления сетью.

[out] parm_err

Указатель на значение, которое получает индекс первого члена информационной структуры группы по ошибке после ERROR_INVALID_PARAMETER кода ошибки. Если этот параметр имеет значение NULL, индекс не возвращается при ошибке. Дополнительные сведения см. в разделе "Примечания".

Возвращаемое значение

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

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

Код возврата	Описание
ERROR_ACCESS_DENIED	У пользователя нет доступа к запрошенной информации.
ERROR_INVALID_PARAMETER	Один из параметров функции недопустим. Дополнительные сведения см. в разделе "Примечания".
NERR_InvalidComputer	Недопустимое имя компьютера.
NERR_NotPrimary	Операция разрешена только на основном контроллере домена.
NERR_GroupNotFound	Не удалось найти имя глобальной группы.
NERR_SpeGroupOp	Операция не допускается в определенных специальных группах. К этим группам относятся группы пользователей, группы администраторов, локальные и гостевые группы.

При программировании для 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