Share via


ReallocADsStr-Funktion (adshlp.h)

Die ReallocADsStr-Funktion erstellt eine Kopie einer Unicode-Zeichenfolge.

Syntax

BOOL ReallocADsStr(
  [out] LPWSTR *ppStr,
  [in]  LPWSTR pStr
);

Parameter

[out] ppStr

Typ: LPWSTR*

Zeiger auf den Zeiger einer null-beendeten Unicode-Zeichenfolge, der die zugeordnete Zeichenfolge empfängt. ReallocADsStr versucht, diesen Arbeitsspeicher mit FreeADsStr freizugeben, bevor die Zeichenfolge neu zugeordnet wird. Daher sollte dieser Parameter mit NULL initialisiert werden, wenn der Arbeitsspeicher nicht freigegeben werden soll oder nicht mit der Funktion AllocADsMem, AllocADsStr, ReallocADsMem oder ReallocADsStr zugeordnet wurde.

Der Aufrufer muss diesen Arbeitsspeicher freigeben, wenn er nicht mehr benötigt wird, indem er diesen Zeiger an FreeADsStr übergibt.

[in] pStr

Typ: LPWSTR

Zeiger auf eine unicode-Zeichenfolge mit Null-Endung, die die zu kopierende Zeichenfolge enthält.

Rückgabewert

Typ: BOOL

Die Funktion gibt BEI erfolgreicher Ausführung TRUE zurück, andernfalls wird FALSE zurückgegeben.

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

AllocADsMem

AllocADsStr

FreeADsStr

ReallocADsMem