Partager via


NetGetDisplayInformationIndex, fonction (lmaccess.h)

La fonction NetGetDisplayInformationIndex retourne l’index de la première entrée d’informations d’affichage dont le nom commence par une chaîne spécifiée ou dont le nom suit la chaîne par ordre alphabétique. Vous pouvez utiliser cette fonction pour déterminer un index de départ pour les appels suivants à la fonction NetQueryDisplayInformation .

Syntaxe

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

Paramètres

[in] ServerName

Pointeur vers une chaîne constante 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é.

[in] Level

Spécifie le niveau des comptes à interroger. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
1
Interroger tous les comptes d’utilisateur locaux et globaux (normaux).
2
Interrogez tous les comptes d’utilisateur de station de travail et de serveur.
3
Interroger tous les groupes globaux.

[in] Prefix

Pointeur vers une chaîne qui spécifie le préfixe pour lequel rechercher.

[out] Index

Pointeur vers une valeur qui reçoit l’index de l’entrée demandée.

Valeur retournée

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

Si la fonction échoue, la valeur de retour peut être l’un des codes d’erreur suivants.

Code de retour Description
ERROR_ACCESS_DENIED
L’utilisateur n’a pas accès aux informations demandées.
ERROR_INVALID_LEVEL
La valeur spécifiée pour le paramètre Level n’est pas valide.
ERROR_NO_MORE_ITEMS
Il n’y avait plus d’éléments sur lesquels fonctionner.
NERR_InvalidComputer
Le nom d'ordinateur est non valide.

Notes

Si vous appelez cette fonction sur un contrôleur de domaine qui exécute Active Directory, l’accès est autorisé ou refusé en fonction de la liste de contrôle d’accès (ACL) de l’objet sécurisable. La liste de contrôle d’accès par défaut permet à tous les utilisateurs authentifiés et aux membres du groupe « Accès compatible pré-Windows 2000 » d’afficher les informations. Si vous appelez cette fonction sur un serveur membre ou une station de travail, tous les utilisateurs authentifiés peuvent afficher les informations. Pour plus d’informations sur l’accès anonyme et la restriction de l’accès anonyme sur ces plateformes, consultez Exigences de sécurité pour les fonctions de gestion réseau. Pour plus d’informations sur les listes de contrôle d’accès, les ACL et les jetons d’accès, consultez Access Control Modèle.

La fonction retourne uniquement les informations auxquelles l’appelant dispose d’un accès en lecture. L’appelant doit disposer d’un accès List Contents à l’objet Domain et énumérer l’accès au domaine SAM entier sur l’objet SAM Server situé dans le conteneur Système.

Configuration requise

   
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)
Bibliothèque Netapi32.lib
DLL Netapi32.dll

Voir aussi

Obtenir des fonctions

NetQueryDisplayInformation

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau