WNetEnumResourceW-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 WNetEnumResourceW(
  [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 dieser Parameter verweist, 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 sowie die Zeichenfolgen zu enthalten, 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	Bei nachfolgenden Aufrufen sind weitere Einträge verfügbar. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
ERROR_INVALID_HANDLE	Das vom 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	Ein netzwerkspezifischer Fehler ist 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. Rufen Sie die NetShareEnum-Funktion auf, um ausgeblendete Freigaben aufzulisten.

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 den Wert von lpBufferSize für die Fehlererkennung 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 die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, 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