ReallocADsStr function (adshlp.h)

The ReallocADsStr function creates a copy of a Unicode string.

Syntax

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

Parameters

[out] ppStr

Type: LPWSTR*

Pointer to null-terminated Unicode string pointer that receives the allocated string. ReallocADsStr will attempt to free this memory with FreeADsStr before reallocating the string, so this parameter should be initialized to NULL if the memory should not be freed or was not allocated with the AllocADsMem, AllocADsStr, ReallocADsMem or ReallocADsStr function.

The caller must free this memory when it is no longer required by passing this pointer to FreeADsStr.

[in] pStr

Type: LPWSTR

Pointer to a null-terminated Unicode string that contains the string to copy.

Return value

Type: BOOL

The function returns TRUE if successful, otherwise FALSE is returned.

Requirements

Requirement Value
Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header adshlp.h
Library Activeds.lib
DLL Activeds.dll

See also

ADSI Functions

AllocADsMem

AllocADsStr

FreeADsStr

ReallocADsMem