Netzwerkverwaltungsfunktionspuffer

Die RPC-Laufzeitbibliothek behandelt die Puffer, die von den 32-Bit-Datenempfangsnetzwerkverwaltungsfunktionen erforderlich sind:

• Senden von Daten an den Server (durch [in]-Parameter angegebene Daten).

  Der Aufrufer muss den Puffer für die relevante Informationsstruktur (oder -strukturen) zuordnen und umstellen und eine Zeigervariable an die Funktion übergeben. Der Aufrufer muss die Pufferlänge nicht angeben.

  Beispiel: NetGroupAdd-

• Abrufen von Daten vom Server (durch [out]-Parameter angegebene Daten).

  Das System weist den Puffer für die zurückgegebenen Informationen zu. Der Aufrufer muss eine Zeigervariable an die Funktion bei eingabe übergeben. Bei erfolgreicher Rückgabe empfängt der Zeiger die Adresse des vom System zugewiesenen Puffers, der die zurückgegebenen Informationen enthält. Dies vereinfacht den aufrufenden Code, da der Aufrufer die Größe des Puffers nicht abschätzen muss, oder die Größe des Puffers ändern und die Funktion erneut aufstellen muss.

  Wenn der Aufrufer die Verarbeitung der zurückgegebenen Informationen abgeschlossen hat, muss er den vom System zugewiesenen Speicher freigeben, indem er die NetApiBufferFree--Funktion aufruft. Weitere Informationen zum Angeben von Puffergrößen finden Sie unter Netzwerkverwaltungsfunktionspufferlängen.

  Beispiel: NetGroupEnum-