NetGetDisplayInformationIndex-Funktion (lmaccess.h)

Die NetGetDisplayInformationIndex-Funktion gibt den Index des ersten Anzeigeinformationseintrags zurück, dessen Name mit einer angegebenen Zeichenfolge beginnt oder dessen Name alphabetisch der Zeichenfolge folgt. Sie können diese Funktion verwenden, um einen Startindex für nachfolgende Aufrufe der NetQueryDisplayInformation-Funktion zu bestimmen.

Syntax

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

Parameter

[in] ServerName

Zeiger auf eine konstante Zeichenfolge, die den DNS- oder NetBIOS-Namen des Remoteservers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] Level

Gibt die Ebene der abzufragenden Konten an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
1	Fragen Sie alle lokalen und globalen (normalen) Benutzerkonten ab.
2	Abfragen aller Arbeitsstations- und Serverbenutzerkonten.
3	Fragen Sie alle globalen Gruppen ab.

[in] Prefix

Zeiger auf eine Zeichenfolge, die das Präfix angibt, nach dem gesucht werden soll.

[out] Index

Zeiger auf einen Wert, der den Index des angeforderten Eintrags empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Rückgabecode	Beschreibung
ERROR_ACCESS_DENIED	Der Benutzer besitzt keinen Zugriff auf die angeforderten Informationen.
ERROR_INVALID_LEVEL	Der für den Level-Parameter angegebene Wert ist ungültig.
ERROR_NO_MORE_ITEMS	Es gab keine weiteren Elemente, die ausgeführt werden konnten.
NERR_InvalidComputer	Der Computername ist ungültig.

Hinweise

Wenn Sie diese Funktion auf einem Domänencontroller aufrufen, auf dem Active Directory ausgeführt wird, wird der Zugriff basierend auf der Zugriffssteuerungsliste (Access Control List, ACL) für das sicherungsfähige Objekt zugelassen oder verweigert. Die Standard-ACL ermöglicht es allen authentifizierten Benutzern und Mitgliedern der Gruppe "Pre-Windows 2000-kompatibler Zugriff", die Informationen anzuzeigen. Wenn Sie diese Funktion auf einem Mitgliedsserver oder einer Arbeitsstation aufrufen, können alle authentifizierten Benutzer die Informationen anzeigen. Informationen zum anonymen Zugriff und zum Einschränken des anonymen Zugriffs auf diesen Plattformen finden Sie unter Sicherheitsanforderungen für die Netzwerkverwaltungsfunktionen. Weitere Informationen zu ACLs, ACEs und Zugriffstoken finden Sie unter Access Control Modell.

Die Funktion gibt nur Informationen zurück, auf die der Aufrufer Lesezugriff hat. Der Aufrufer muss über Listeninhaltszugriff auf das Domain-Objekt und den Zugriff auf die gesamte SAM-Domäne auf das SAM Server-Objekt im Systemcontainer aufzählen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmaccess.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

Abrufen von Funktionen

NetQueryDisplayInformation

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung