Función NetGroupGetInfo (lmaccess.h)

Artículo
02/28/2024

La función NetGroupGetInfo recupera información sobre un grupo global determinado en la base de datos de seguridad, que es la base de datos del administrador de cuentas de seguridad (SAM) o, en el caso de controladores de dominio, Active Directory.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetGroupGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR groupname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

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 del grupo global para el que se va a recuperar información. 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	Devuelve el nombre del grupo global. El parámetro bufptr apunta a una estructura GROUP_INFO_0 .
1	Devuelve el nombre del grupo global y un comentario. El parámetro bufptr apunta a una estructura GROUP_INFO_1 .
2	Devuelve información detallada sobre el grupo global. El parámetro bufptr apunta a una estructura GROUP_INFO_2 . Tenga en cuenta que en Windows XP y versiones posteriores, se recomienda usar GROUP_INFO_3 en su lugar.
3	Devuelve información detallada sobre el grupo global. El parámetro bufptr apunta a una estructura GROUP_INFO_3 . Windows 2000: Este nivel no se admite.

[out] bufptr

Puntero a la dirección del búfer que recibe la estructura de información del grupo global. El formato de estos datos depende del valor del parámetro level . El sistema asigna la memoria para este búfer. Debe llamar a la función NetApiBufferFree para desasignar la memoria. Para obtener más información, consulte Network Management Function Buffers (Búferes de funciones de administración de red) y Network Management Function Buffer Lengths (Longitudes de búfer de funciones de administración de red).

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.
NERR_InvalidComputer	El nombre de equipo no es válido.
NERR_GroupNotFound	No se encontró el nombre del grupo global.

Comentarios

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

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 permite que todos los usuarios y miembros autenticados del grupo "Acceso compatible con Pre-Windows 2000" vean la información. Si llama a esta función en un servidor miembro o estación de trabajo, todos los usuarios autenticados pueden ver la información. Para obtener información sobre el acceso anónimo y restringir el acceso anónimo en estas plataformas, consulte Requisitos de seguridad para las funciones de administración de redes. 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 Group se usa para realizar la comprobación de acceso de esta función.

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.

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