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 |