Compartir a través de

Función SysReAllocStringLen (oleauto.h)

  • Artículo

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