Función NetAccessEnum (lmaccess.h)

[Esta función está obsoleta. Para obtener una lista de funciones alternativas, consulte Funciones de autorización.

No compatible.

La función NetAccessEnum recupera información sobre cada registro de permisos de acceso.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetAccessEnum(
  LPCWSTR servername,
  LPCWSTR BasePath,
  DWORD   Recursive,
  DWORD   level,
  LPBYTE  *bufptr,
  DWORD   prefmaxlen,
  LPDWORD entriesread,
  LPDWORD totalentries,
  LPDWORD resume_handle
);

Parámetros

servername

Puntero a una cadena 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.

BasePath

Puntero a una cadena que contiene un nombre de ruta de acceso base para el recurso. Un puntero NULL o una cadena NULL significa que no se va a usar ninguna ruta de acceso base. La ruta de acceso se puede especificar como un nombre de ruta de acceso de convención de nomenclatura universal (UNC).

Recursive

Especifica una marca que habilita o deshabilita la búsqueda recursiva.

Si este parámetro es igual a cero, la función NetAccessEnum devuelve entradas para el recurso denominado como ruta de acceso base por el parámetro pszBasePath y para los recursos directamente debajo de esa ruta de acceso base.

Si este parámetro es distinto de cero, la función devuelve entradas para todas las listas de control de acceso (ACL) que tienen pszBasePath al principio del nombre del recurso.

level

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

Valor	Significado
0	El parámetro pbBuffer apunta a una estructura de access_info_0 .
1	El parámetro pbBuffer apunta a una estructura de access_info_1 .

bufptr

Puntero al búfer que recibe la estructura de información de acceso. El formato de estos datos depende del valor del parámetro sLevel .

prefmaxlen

Especifica el tamaño, en bytes, del búfer al que apunta el parámetro pbBuffer .

entriesread

Puntero a un entero corto sin signo que recibe el recuento de elementos enumerados realmente. El recuento solo es válido si la función NetAccessEnum devuelve NERR_Success o ERROR_MORE_DATA.

totalentries

Puntero a un entero corto sin signo que recibe el número total de entradas que se podrían haber enumerado. El recuento solo es válido si la función NetAccessEnum devuelve NERR_Success o ERROR_MORE_DATA.

resume_handle

TBD

Valor devuelto

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

Si se produce un error en la función, el valor devuelto es un código de error del sistema. Para obtener una lista de códigos de error, consulte Códigos de error del sistema.

Comentarios

Esta función requiere Administración privilegios para ejecutarse correctamente en un equipo que tenga habilitada la seguridad local.

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, Lmaccess.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll

Consulte también

Funciones de autorización