AllocADsStr-Funktion (adshlp.h)
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 |