Función NetLocalGroupSetInfo (lmaccess.h)

Artículo
02/28/2024

La función NetLocalGroupSetInfo cambia el nombre de un grupo local existente. La función también asocia un comentario a un grupo local.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetLocalGroupSetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR groupname,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parámetros

[in] servername

Puntero a una cadena constante que especifica el nombre DNS o NetBIOS del servidor remoto en el que se va a ejecutar la función. Si este parámetro es NULL, se usa el equipo local.

[in] groupname

Puntero a una cadena constante que especifica el nombre de la cuenta de grupo local que se va a modificar. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[in] level

Especifica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
0	Especifica el nombre del grupo local. El parámetro buf apunta a una estructura LOCALGROUP_INFO_0 . Use este nivel para cambiar el nombre de un grupo local existente.
1	Especifica el nombre del grupo local y un comentario que se va a asociar al grupo. El parámetro buf apunta a una estructura LOCALGROUP_INFO_1 .
1002	Especifica un comentario que se va a asociar al grupo local. El parámetro buf apunta a una estructura LOCALGROUP_INFO_1002 .

[in] buf

Puntero a un búfer que contiene la información del grupo local. El formato de estos datos depende del valor del parámetro level . Para obtener más información, consulte Búferes de funciones de administración de red.

[out] parm_err

Puntero a un valor que recibe el índice del primer miembro de la estructura de información del grupo local que provocó el error ERROR_INVALID_PARAMETER. Si este parámetro es NULL, el índice no se devuelve en caso de error. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	El usuario no tiene acceso a la información pedida.
ERROR_INVALID_PARAMETER	Uno de los parámetros de función no es válido. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
ERROR_NO_SUCH_ALIAS	El grupo local especificado no existe.
NERR_NotPrimary	La operación solo se permite en el controlador de dominio principal del dominio.
NERR_InvalidComputer	El nombre de equipo no es válido.

Comentarios

Si llama a esta función en un controlador de dominio que ejecuta Active Directory, se permite o se deniega el acceso en función de la lista de control de acceso (ACL) para el objeto protegible. La ACL predeterminada solo permite que los administradores de dominio y los operadores de cuenta llamen a esta función. En un servidor miembro o estación de trabajo, solo los administradores y los usuarios avanzados pueden llamar a esta función. Para obtener más información, consulte Requisitos de seguridad para las funciones de administración de red. Para obtener más información sobre las ACL, los ACL y los tokens de acceso, consulte Access Control Modelo.

El descriptor de seguridad del objeto LocalGroup se usa para realizar la comprobación de acceso de esta función. Normalmente, los llamadores deben tener acceso de escritura a todo el objeto para que las llamadas a esta función se realicen correctamente.

Para especificar el nuevo nombre de un grupo local existente, llame a NetLocalGroupSetInfo con LOCALGROUP_INFO_0 y especifique un valor mediante el miembro lgrpi0_name . Si llama a la función NetLocalGroupSetInfo con LOCALGROUP_INFO_1 y especifica un nuevo valor mediante el miembro lgrpi1_name , se omitirá ese valor.

Si la función NetLocalGroupSetInfo devuelve ERROR_INVALID_PARAMETER, puede usar el parámetro parm_err para indicar el primer miembro de la estructura de información del grupo local que no es válida. (Una estructura de información de grupo local comienza por LOCALGROUP_INFO_ y su formato se especifica mediante el parámetro level ). En la tabla siguiente se enumeran los valores que se pueden devolver en el parámetro parm_err y el miembro de estructura correspondiente que se encuentra en error. (El prefijo lgrpi*_ indica que el miembro puede comenzar con varios prefijos, por ejemplo, lgrpi0_ o lgrpi1_).

Valor	Miembro
LOCALGROUP_NAME_PARMNUM	lgrpi*_name
LOCALGROUP_COMMENT_PARMNUM	lgrpi*_comment

Los nombres de cuenta de usuario están limitados a 20 caracteres y los nombres de grupo están limitados a 256 caracteres. Además, los nombres de cuenta no se pueden terminar por un punto y no pueden incluir comas ni ninguno de los siguientes caracteres imprimibles: ", /, , [, ], :, |, <, , >+, =, ;, ?, *. Los nombres tampoco pueden incluir caracteres en el intervalo 1-31, que no son imprimibles.

Si está programando para Active Directory, es posible que pueda llamar a determinados métodos de la Interfaz de servicio de Active Directory (ADSI) para lograr la misma funcionalidad que puede lograr llamando a las funciones del grupo local de administración de red. Para obtener más información, consulte IADsGroup.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmaccess.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll