Función SysReAllocStringLen (oleauto.h)

Crea un nuevo BSTR que contiene un número especificado de caracteres de un BSTR antiguo y libera el BSTR antiguo.

Sintaxis

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

Parámetros

[in, out] pbstr

Cadena asignada anteriormente.

[in, optional] psz

Cadena de la que se van a copiar caracteres len o NULL para mantener la cadena sin inicializar.

[in] len

Número de caracteres que se van a copiar. Un carácter nulo se coloca después, asignando un total de len más uno caracteres.

Valor devuelto

Código devuelto	Descripción
TRUE	La cadena se reasigna correctamente.
FALSE	Existe memoria insuficiente.

Comentarios

Asigna una nueva cadena, copia los caracteres len de la cadena pasada en ella y, a continuación, anexa un carácter NULO. Libera el BSTR al que hace referencia actualmente pbstr y restablece pbstr para que apunte al nuevo BSTR. Si psz es null, se asigna una cadena de longitud len pero no se inicializa.

La cadena psz puede contener caracteres NULL incrustados y no necesita terminar con un valor NULL.

Si esta función se pasa a un puntero NULL, habrá una infracción de acceso y el programa se bloqueará. Es su responsabilidad proteger esta función frente a punteros NULL.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	oleauto.h
Library	OleAut32.lib
Archivo DLL	OleAut32.dll

Consulte también

Funciones de manipulación de cadenas