Función NetGetDisplayInformationIndex (lmaccess.h)

  • Artículo

La función NetGetDisplayInformationIndex devuelve el índice de la primera entrada de información para mostrar cuyo nombre comienza con una cadena especificada o cuyo nombre sigue alfabéticamente la cadena. Puede usar esta función para determinar un índice inicial para las llamadas posteriores a la función NetQueryDisplayInformation .

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetGetDisplayInformationIndex(
  [in]  LPCWSTR ServerName,
  [in]  DWORD   Level,
  [in]  LPCWSTR Prefix,
  [out] LPDWORD Index
);

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] Level

Especifica el nivel de cuentas que se van a consultar. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
1
 Consulte todas las cuentas de usuario locales y globales (normales).
2
 Consulte todas las cuentas de usuario de estación de trabajo y servidor.
3
 Consulte todos los grupos globales.

[in] Prefix

Puntero a una cadena que especifica el prefijo para el que se va a buscar.

[out] Index

Puntero a un valor que recibe el índice de la entrada solicitada.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se 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_LEVEL
 El valor especificado para el parámetro Level no es válido.
ERROR_NO_MORE_ITEMS
 No había más elementos en los que operar.
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 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 red. Para obtener más información sobre las ACL, los ACL y los tokens de acceso, consulte Access Control Model.

La función solo devuelve información a la que el autor de la llamada tiene acceso de lectura. El autor de la llamada debe tener acceso List Contents al objeto Domain y Enumerar todo el acceso de dominio SAM en el objeto SAM Server ubicado en el contenedor System.

Requisitos

   
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

Consulte también

Obtener funciones

NetQueryDisplayInformation

Funciones de administración de red

Introducción a la administración de redes