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 Enumerationsfunktionen der Netzwerkverwaltung (und verschiedenen Datenabruffunktionen) angeben, müssen Puffer angeben, die groß genug sind, um die zurückgegebene Informationsstruktur (oder -strukturen) sowie die Zeichenfolgen zu enthalten, auf die ihre Member zeigen. Wenn Sie keinen ausreichend großen Puffer angeben, um alle verfügbaren Einträge zu empfangen, gibt die Funktion ERROR _ MORE _ DATA zurück. Enumerationsaufrufe geben keine partiellen Einträge zurück.

Für einige Netzwerkverwaltungsfunktionen wird der Parameter prefmaxlen mit maximaler Datenlänge als Empfehlung verwendet. Mit diesem Parameter kann eine Anwendung die Anzahl von Bytes vorschlagen, die der Server von einem Funktionsaufruf zurückgeben soll.

Wenn Sie den Wert MAX PREFERRED LENGTH im _ _ parameter prefmaxlen angeben, weisen die Netzwerkverwaltungsfunktionen die Menge an Arbeitsspeicher zu, die für die Daten erforderlich ist.

Weitere Informationen finden Sie unter Puffer für Netzwerkverwaltungsfunktionen.