AllocADsMem-Funktion (adshlp.h)

Artikel
03/01/2024

Die AllocADsMem-Funktion weist einen Speicherblock der angegebenen Größe zu.

Syntax

LPVOID AllocADsMem(
  [in] DWORD cb
);

Parameter

[in] cb

Art: DWORD

Enthält die zuzuordnende Größe in Bytes.

Rückgabewert

Typ: LPVOID

Bei erfolgreicher Ausführung gibt die Funktion einen Zeiger ungleich NULL auf den zugeordneten Arbeitsspeicher zurück. Der Aufrufer muss diesen Arbeitsspeicher freigeben, wenn er nicht mehr benötigt wird, indem er den zurückgegebenen Zeiger an FreeADsMem übergibt.

Gibt NULL zurück, wenn dies nicht erfolgreich ist. Rufen Sie ADsGetLastError auf, um einen erweiterten Fehler status zu erhalten. Weitere Informationen zu Fehlercodewerten finden Sie unter ADSI-Fehlercodes.

Hinweise

Der von AllocADsMem zurückgegebene Speicherblock wird mit 0 (null) initialisiert.

Weitere Informationen und ein Codebeispiel zur Verwendung der AllocADsMem-Funktion finden Sie unter ReallocADsMem.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	adshlp.h
Bibliothek	Activeds.lib
DLL	Activeds.dll; AdsLdpc.dll