WNetEnumResourceA-Funktion (winnetwk.h)

Artikel
08/27/2023

Die WNetEnumResource-Funktion setzt eine Enumeration von Netzwerkressourcen fort, die durch einen Aufruf der WNetOpenEnum-Funktion gestartet wurde.

Syntax

DWORD WNetEnumResourceA(
  [in]      HANDLE  hEnum,
  [in, out] LPDWORD lpcCount,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parameter

[in] hEnum

Handle, das eine Enumeration instance identifiziert. Dieses Handle muss von der WNetOpenEnum-Funktion zurückgegeben werden.

[in, out] lpcCount

Zeiger auf eine Variable, die die Anzahl der angeforderten Einträge angibt. Wenn die angeforderte Zahl –1 ist, gibt die Funktion so viele Einträge wie möglich zurück.

Wenn die Funktion erfolgreich ist, enthält die Variable, auf die von diesem Parameter verwiesen wird, die Anzahl der tatsächlich gelesenen Einträge.

[out] lpBuffer

Zeiger auf den Puffer, der die Enumerationsergebnisse empfängt. Die Ergebnisse werden als Array von NETRESOURCE-Strukturen zurückgegeben. Beachten Sie, dass der Puffer, den Sie zuweisen, groß genug sein muss, um die Strukturen und die Zeichenfolgen aufzunehmen, auf die ihre Member verweisen. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Der Puffer ist bis zum nächsten Aufruf mit dem vom hEnum-Parameter angegebenen Handle gültig. Die Reihenfolge der NETRESOURCE-Strukturen im Array ist nicht vorhersagbar.

[in, out] lpBufferSize

Zeiger auf eine Variable, die die Größe des lpBuffer-Parameters in Bytes angibt. Wenn der Puffer zu klein ist, um auch nur einen Eintrag zu empfangen, empfängt dieser Parameter die erforderliche Größe des Puffers.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert einer der folgenden Werte.

Rückgabecode	Beschreibung
NO_ERROR	Die Enumeration war erfolgreich, und der Puffer enthält die angeforderten Daten. Die aufrufende Anwendung kann weiterhin WNetEnumResource aufrufen, um die Enumeration abzuschließen.
ERROR_NO_MORE_ITEMS	Es gibt keine weiteren Einträge. Der Pufferinhalt ist nicht definiert.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. einer der folgenden Werte.

Rückgabecode	Beschreibung
ERROR_MORE_DATA	Weitere Einträge sind bei nachfolgenden Aufrufen verfügbar. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
ERROR_INVALID_HANDLE	Das durch den hEnum-Parameter angegebene Handle ist ungültig.
ERROR_NO_NETWORK	Das Netzwerk ist nicht verfügbar. (Diese Bedingung wird getestet, bevor hEnum auf Gültigkeit getestet wird.)
ERROR_EXTENDED_ERROR	Es ist ein netzwerkspezifischer Fehler aufgetreten. Rufen Sie die WNetGetLastError-Funktion auf, um eine Beschreibung des Fehlers zu erhalten.

Hinweise

Die WNetEnumResource-Funktion listet keine Benutzer auf, die mit einer Freigabe verbunden sind. Sie können die NetConnectionEnum-Funktion aufrufen, um diese Aufgabe auszuführen. Um ausgeblendete Freigaben aufzulisten, rufen Sie die NetShareEnum-Funktion auf .

Eine Anwendung kann den lpBuffer-Parameter nicht auf NULL festlegen und die erforderliche Puffergröße aus dem lpBufferSize-Parameter abrufen. Stattdessen sollte die Anwendung einen Puffer einer angemessenen Größe zuordnen – typischerweise 16 KB – und für die Fehlererkennung den Wert von lpBufferSize verwenden.

Beispiele

Ein Codebeispiel, das eine anwendungsdefinierte Funktion veranschaulicht, die alle Ressourcen in einem Netzwerk aufzählt, finden Sie unter Auflisten von Netzwerkressourcen.

Hinweis

Der winnetwk.h-Header definiert WNetEnumResource als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winnetwk.h
Bibliothek	Mpr.lib
DLL	Mpr.dll