Pufferlängen der Netzwerkverwaltungsfunktion

In diesem Thema werden die Anforderungen für Funktionspufferlängen erläutert, wenn sie mit den Netzwerkverwaltungs-APIs verwendet werden.

Anwendungen, die Puffergrößen beim Aufrufen von Netzwerkverwaltungsaufzählungsfunktionen (und verschiedenen Datenabruffunktionen) angeben, müssen Puffer angeben, die groß genug sind, um die zurückgegebene Informationsstruktur (oder -strukturen) und die Zeichenfolgen zu enthalten, auf die ihre Member verweisen. Wenn Sie nicht einen ausreichend großen Puffer angeben, um alle verfügbaren Einträge zu empfangen, gibt die Funktion ERROR_MORE_DATA zurück. Enumerationsaufrufe geben keine Teileinträge zurück.

Einige Netzwerkverwaltungsfunktionen verwenden einen empfohlenen Parameter für die maximale Datenlänge, prefmaxlen. Mit diesem Parameter kann eine Anwendung die Anzahl der Bytes vorschlagen, die der Server von einem Funktionsaufruf zurückgeben soll.

Wenn Sie den Wert MAX_PREFERRED_LENGTH im prefmaxlen-Parameter angeben, weisen die Netzwerkverwaltungsfunktionen die menge des für die Daten erforderlichen Arbeitsspeichers zu.

Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer.