Funzione NetAccessEnum (lmaccess.h)

[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.

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

Vedi anche

Funzioni di autorizzazione