Puffer für Netzwerkverwaltungsfunktionen
Die RPC-Laufzeitbibliothek verarbeitet die Puffer, die für die 32-Bit-Datenabruf-Netzwerkverwaltungsfunktionen erforderlich sind, wie folgt:
Senden von Daten an den Server (Daten, die von in [ Parametern angegeben ] werden).
Der Aufrufer muss den Puffer für die relevante Informationsstruktur (oder -strukturen) zuordnen und seine Zuordnung wieder aufteilen 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 ordnet den Puffer für die zurückgegebenen Informationen zu. Der Aufrufer muss bei der Eingabe eine Zeigervariable an die Funktion übergeben. Bei erfolgreicher Rückgabe empfängt der Zeiger die Adresse des vom System zugeordneten Puffers, der die zurückgegebenen Informationen enthält. Dies vereinfacht den aufrufenden Code, da der Aufrufer weder die Größe des Puffers schätzen noch die Größe des Puffers ändern und die Funktion erneut ausführen muss.
Wenn der Aufrufer die Verarbeitung der zurückgegebenen Informationen abgeschlossen hat, muss er den vom System zugewiesenen Arbeitsspeicher durch Aufrufen der NetApiBufferFree-Funktion frei geben. Weitere Informationen zum Angeben von Puffergrößen finden Sie unter Pufferlängen der Netzwerkverwaltungsfunktion.
Beispiel: NetGroupEnum