Compartilhar via


Função SysReAllocString (oleauto.h)

Realoca uma cadeia de caracteres alocada anteriormente para ter o tamanho de uma segunda cadeia de caracteres e copia a segunda cadeia de caracteres para a memória realocada.

Sintaxe

INT SysReAllocString(
  [in, out]      BSTR          *pbstr,
  [in, optional] const OLECHAR *psz
);

Parâmetros

[in, out] pbstr

A cadeia de caracteres alocada anteriormente.

[in, optional] psz

A cadeia de caracteres a ser copiada.

Retornar valor

Código de retorno Descrição
TRUE
A cadeia de caracteres é realocada com êxito.
FALSE
Há memória insuficiente.

Comentários

O endereço passado em psz não pode fazer parte da cadeia de caracteres passada em pbstr ou podem ocorrer resultados inesperados.

Se pbstr for NULL, haverá uma violação de acesso e o programa falhará. É sua responsabilidade proteger essa função contra ponteiros NULL.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oleauto.h
Biblioteca OleAut32.lib
DLL OleAut32.dll

Confira também

Funções de manipulação de cadeia de caracteres