NetAccessEnum-Funktion (lmaccess.h)

Artikel
08/24/2023

[Diese Funktion ist veraltet. Eine Liste mit alternativen Funktionen finden Sie unter Autorisierungsfunktionen.]

Wird nicht unterstützt.

Die NetAccessEnum-Funktion ruft Informationen zu jedem Zugriffsberechtigungsdatensatz ab.

Syntax

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

Parameter

servername

Zeiger auf eine 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.

BasePath

Zeiger auf eine Zeichenfolge, die einen Basispfadnamen für die Ressource enthält. Ein NULL-Zeiger oder eine NULL-Zeichenfolge bedeutet, dass kein Basispfad verwendet werden soll. Der Pfad kann als UNC-Pfadname (Universal Naming Convention) angegeben werden.

Recursive

Gibt ein Flag an, das die rekursive Suche aktiviert oder deaktiviert.

Wenn dieser Parameter gleich 0 ist, gibt die NetAccessEnum-Funktion Einträge für die Ressource zurück, die vom pszBasePath-Parameter als Basispfad benannt ist, und für die Ressourcen direkt unter diesem Basispfad.

Wenn dieser Parameter nichtzero ist, gibt die Funktion Einträge für alle Zugriffssteuerungslisten (Access Control Lists, ACLs) zurück, die am Anfang des Ressourcennamens pszBasePath aufweisen.

level

Gibt die Informationsebene der Daten an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
0	Der pbBuffer-Parameter verweist auf eine access_info_0-Struktur .
1	Der pbBuffer-Parameter verweist auf eine access_info_1-Struktur .

bufptr

Zeiger auf den Puffer, der die Zugriffsinformationsstruktur empfängt. Das Format dieser Daten hängt vom Wert des sLevel-Parameters ab.

prefmaxlen

Gibt die Größe des Puffers in Bytes an, auf den der pbBuffer-Parameter verweist.

entriesread

Zeiger auf eine ganzzahlige Ganzzahl ohne Vorzeichen, die die Anzahl der tatsächlich aufgelisteten Elemente empfängt. Die Anzahl ist nur gültig, wenn die NetAccessEnum-FunktionNERR_Success oder ERROR_MORE_DATA zurückgibt.

totalentries

Zeiger auf eine ganzzahlige Ganzzahl ohne Vorzeichen, die die Gesamtanzahl von Einträgen empfängt, die hätten aufgezählt werden können. Die Anzahl ist nur gültig, wenn die NetAccessEnum-FunktionNERR_Success oder ERROR_MORE_DATA zurückgibt.

resume_handle

TBD

Rückgabewert

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Diese Funktion erfordert Admin Berechtigung, um erfolgreich auf einem Computer ausgeführt zu werden, auf dem die lokale Sicherheit aktiviert ist.

Anforderungen

Anforderung	Wert
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 (einschließlich Lm.h, Lmaccess.h)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

Autorisierungsfunktionen

Share via