NetApiBufferReallocate-Funktion (lmapibuf.h)

Die NetApiBufferReallocate-Funktion ändert die Größe eines Puffers, der durch einen vorherigen Aufruf der NetApiBufferAllocate-Funktion zugewiesen wurde.

Syntax

NET_API_STATUS NET_API_FUNCTION NetApiBufferReallocate(
  [in]  _Frees_ptr_opt_ LPVOID OldBuffer,
  [in]  DWORD                  NewByteCount,
  [out] LPVOID                 *NewBuffer
);

Parameter

[in] OldBuffer

Zeiger auf den Puffer, der von einem Aufruf der NetApiBufferAllocate-Funktion zurückgegeben wird.

[in] NewByteCount

Gibt die neue Größe des Puffers in Bytes an.

[out] NewBuffer

Empfängt den Zeiger auf den neu zugeordneten Puffer.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode. Eine Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Es ist keine spezielle Gruppenmitgliedschaft erforderlich, um die ApiBuffer-Funktionen erfolgreich auszuführen.

Ein Codebeispiel, das die Verwendung der ApiBuffer-Funktionen für die Netzwerkverwaltung veranschaulicht, finden Sie unter NetApiBufferAllocate.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmapibuf.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll

Weitere Informationen

API-Pufferfunktionen

NetApiBufferAllocate

NetApiBufferFree

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung