Freigeben über

Puffer für Netzwerkverwaltungsfunktionen

  • Artikel

Die RPC-Laufzeitbibliothek verarbeitet die Puffer, die für die Netzwerkverwaltungsfunktionen für den 32-Bit-Datenabruf erforderlich sind:

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

    Der Aufrufer muss den Puffer für die relevante Informationsstruktur (oder Strukturen) zuordnen und abteilen 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 bei der Eingabe eine Zeigervariable an die Funktion übergeben. Bei erfolgreicher Rückgabe empfängt der Zeiger die Adresse des vom System zugewiesenen Puffers, der die zurückgegebenen Informationen enthält. Dadurch wird der aufrufende Code vereinfacht, da der Aufrufer die Größe des Puffers nicht schätzen oder die Größe des Puffers ändern und die Funktion erneut ausstellen muss.

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

    Beispiel: NetGroupEnum