NetAccessEnum, fonction (lmaccess.h)

Article
02/28/2024

[Cette fonction est obsolète. Pour obtenir la liste des fonctions secondaires, consultez Fonctions d’autorisation.]

Non pris en charge.

La fonction NetAccessEnum récupère des informations sur chaque enregistrement d’autorisation d’accès.

Syntaxe

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

Paramètres

servername

Pointeur vers une chaîne qui spécifie le nom DNS ou NetBIOS du serveur distant sur lequel la fonction doit s’exécuter. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

BasePath

Pointeur vers une chaîne qui contient un nom de chemin d’accès de base pour la ressource. Un pointeur NULL ou une chaîne NULL signifie qu’aucun chemin d’accès de base ne doit être utilisé. Le chemin d’accès peut être spécifié sous la forme d’un chemin d’accès UNC (Universal Naming Convention).

Recursive

Spécifie un indicateur qui active ou désactive la recherche récursive.

Si ce paramètre est égal à zéro, la fonction NetAccessEnum retourne des entrées pour la ressource nommée comme chemin de base par le paramètre pszBasePath et pour les ressources situées juste en dessous de ce chemin de base.

Si ce paramètre n’est pas nul, la fonction retourne des entrées pour toutes les listes de contrôle d’accès (ACL) qui ont pszBasePath au début du nom de la ressource.

level

Spécifie le niveau d’informations des données. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
0	Le paramètre pbBuffer pointe vers une structure access_info_0 .
1	Le paramètre pbBuffer pointe vers une structure access_info_1 .

bufptr

Pointeur vers la mémoire tampon qui reçoit la structure des informations d’accès. Le format de ces données dépend de la valeur du paramètre sLevel .

prefmaxlen

Spécifie la taille, en octets, de la mémoire tampon pointée vers le paramètre pbBuffer .

entriesread

Pointeur vers un entier court non signé qui reçoit le nombre d’éléments réellement énumérés. Le nombre est valide uniquement si la fonction NetAccessEnum retourne NERR_Success ou ERROR_MORE_DATA.

totalentries

Pointeur vers un entier court non signé qui reçoit le nombre total d’entrées qui auraient pu être énumérées. Le nombre est valide uniquement si la fonction NetAccessEnum retourne NERR_Success ou ERROR_MORE_DATA.

resume_handle

TBD

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour est un code d’erreur système. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur système.

Remarques

Cette fonction nécessite Administration privilège pour s’exécuter correctement sur un ordinateur sur lequel la sécurité locale est activée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmaccess.h (include Lm.h, Lmaccess.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll

Voir aussi

Fonctions d’autorisation