Compartilhar via


Função ReallocADsStr (adshlp.h)

A função ReallocADsStr cria uma cópia de uma cadeia de caracteres Unicode.

Sintaxe

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

Parâmetros

[out] ppStr

Tipo: LPWSTR*

Ponteiro para o ponteiro de cadeia de caracteres Unicode terminada em nulo que recebe a cadeia de caracteres alocada. ReallocADsStr tentará liberar essa memória com FreeADsStr antes de realocar a cadeia de caracteres, portanto, esse parâmetro deverá ser inicializado como NULL se a memória não deve ser liberada ou não foi alocada com a função AllocADsMem, AllocADsStr, ReallocADsMem ou ReallocADsStr .

O chamador deve liberar essa memória quando ela não for mais necessária passando esse ponteiro para FreeADsStr.

[in] pStr

Tipo: LPWSTR

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém a cadeia de caracteres a ser copiada.

Retornar valor

Tipo: BOOL

A função retornará TRUE se tiver êxito; caso contrário, FALSE será retornado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho adshlp.h
Biblioteca Activeds.lib
DLL Activeds.dll

Confira também

Funções ADSI

AllocADsMem

AllocADsStr

FreeADsStr

ReallocADsMem