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.
[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 |
|---|---|
|
L’utilisateur n’a pas accès aux informations demandées. |
|
La valeur spécifiée pour le paramètre Level n’est pas valide. |
|
Il n’y avait plus d’éléments sur lesquels fonctionner. |
|
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 |