Share via

Função SysReAllocStringLen (oleauto.h)

  • Artigo

Cria um novo BSTR que contém um número especificado de caracteres de um BSTR antigo e libera o BSTR antigo.

Sintaxe

INT SysReAllocStringLen(
  [in, out]      BSTR          *pbstr,
  [in, optional] const OLECHAR *psz,
  [in]           unsigned int  len
);

Parâmetros

[in, out] pbstr

A cadeia de caracteres alocada anteriormente.

[in, optional] psz

A cadeia de caracteres da qual copiar caracteres len ou NULL para manter a cadeia de caracteres não inicializada.

[in] len

O número de caracteres a serem copiados. Um caractere nulo é colocado posteriormente, alocando um total de len mais um caractere.

Retornar valor

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

Comentários

Aloca uma nova cadeia de caracteres, copia caracteres len da cadeia de caracteres passada para ela e acrescenta um caractere nulo. Libera o BSTR referenciado atualmente por pbstr e redefine pbstr para apontar para o novo BSTR. Se psz for nulo, uma cadeia de caracteres de comprimento len será alocada, mas não inicializada.

A cadeia de caracteres psz pode conter caracteres nulos inseridos e não precisa terminar com um nulo.

Se essa função for passada por um ponteiro 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