Freigeben über


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

Weitere Informationen

ADSI-Funktionen

ADsGetLastError

FreeADsStr

ReallocADsStr