AllocADsStr-Funktion (adshlp.h)

Artikel
02/26/2024

Die AllocADsStr-Funktion reserviert Arbeitsspeicher für und kopiert eine angegebene Zeichenfolge.

Syntax

LPWSTR AllocADsStr(
  [in] LPCWSTR pStr
);

Parameter

[in] pStr

Typ: LPWSTR

Zeiger auf eine zu kopierende Unicode-Zeichenfolge mit NULL-Beendigung.

Rückgabewert

Typ: LPWSTR

Bei erfolgreicher Ausführung gibt die Funktion einen Zeiger ungleich NULL auf den zugeordneten Arbeitsspeicher zurück. Die Zeichenfolge in pStr wird in diesen Puffer kopiert und null-terminated. Der Aufrufer muss diesen Arbeitsspeicher freigeben, wenn er nicht mehr benötigt wird, indem er den zurückgegebenen Zeiger an FreeADsStr übergibt.

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

Hinweise

Weitere Informationen und ein Codebeispiel zur Verwendung der AllocADsStr-Funktion finden Sie unter ReallocADsStr.

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

Weitere Informationen

Share via