Funzione NetAccessEnum (lmaccess.h)

Articolo
03/09/2023

[Questa funzione è obsoleta. Per un elenco di funzioni alternative, vedere Funzioni di autorizzazione.

Non supportato.

La funzione NetAccessEnum recupera informazioni su ogni record di autorizzazione di accesso.

Sintassi

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
);

Parametri

servername

Puntatore a una stringa che specifica il nome DNS o NetBIOS del server remoto in cui eseguire la funzione. Se questo parametro è NULL, viene usato il computer locale.

BasePath

Puntatore a una stringa contenente un nome percorso di base per la risorsa. Un puntatore NULL o una stringa NULL significa che non deve essere usato alcun percorso di base. Il percorso può essere specificato come nome di percorso UNC (Universal Naming Convention).

Recursive

Specifica un flag che abilita o disabilita la ricerca ricorsiva.

Se questo parametro è uguale a zero, la funzione NetAccessEnum restituisce voci per la risorsa denominata come percorso di base dal parametro pszBasePath e per le risorse direttamente sotto il percorso di base.

Se questo parametro è diverso da zero, la funzione restituisce voci per tutti gli elenchi di controllo di accesso (ACL) con pszBasePath all'inizio del nome della risorsa.

level

Specifica il livello di informazioni dei dati. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
0	Il parametro pbBuffer punta a una struttura access_info_0 .
1	Il parametro pbBuffer punta a una struttura access_info_1 .

bufptr

Puntatore al buffer che riceve la struttura delle informazioni di accesso. Il formato di questi dati dipende dal valore del parametro sLevel .

prefmaxlen

Specifica le dimensioni, in byte, del buffer a cui punta il parametro pbBuffer .

entriesread

Puntatore a un intero corto senza segno che riceve il conteggio degli elementi effettivamente enumerati. Il conteggio è valido solo se la funzione NetAccessEnum restituisce NERR_Success o ERROR_MORE_DATA.

totalentries

Puntatore a un intero corto senza segno che riceve il numero totale di voci che potrebbero essere state enumerate. Il conteggio è valido solo se la funzione NetAccessEnum restituisce NERR_Success o ERROR_MORE_DATA.

resume_handle

TBD

Valore restituito

Se la funzione ha esito positivo, il valore restituito è NERR_Success.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema. Per un elenco di codici di errore, vedere Codici di errore di sistema.

Commenti

Questa funzione richiede Amministrazione privilegio per l'esecuzione corretta in un computer con sicurezza locale abilitato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lmaccess.h (include Lm.h, Lmaccess.h)
Libreria	Netapi32.lib
DLL	Netapi32.dll

Vedi anche

Funzioni di autorizzazione

Condividi tramite