WNetEnumResourceA-Funktion (winnetwk.h)
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 |
---|---|
|
Die Enumeration war erfolgreich, und der Puffer enthält die angeforderten Daten. Die aufrufende Anwendung kann weiterhin WNetEnumResource aufrufen, um die Enumeration abzuschließen. |
|
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 |
---|---|
|
Weitere Einträge sind bei nachfolgenden Aufrufen verfügbar. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise". |
|
Das durch den hEnum-Parameter angegebene Handle ist ungültig. |
|
Das Netzwerk ist nicht verfügbar. (Diese Bedingung wird getestet, bevor hEnum auf Gültigkeit getestet wird.) |
|
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 |