Condividi tramite


Funzione SysReAllocStringLen (oleauto.h)

Crea un nuovo BSTR contenente un numero specificato di caratteri da un BSTR precedente e libera il precedente BSTR.

Sintassi

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

Parametri

[in, out] pbstr

Stringa allocata in precedenza.

[in, optional] psz

Stringa da cui copiare i caratteri len o NULL per mantenere la stringa non inizializzata.

[in] len

Numero di caratteri da copiare. Un carattere Null viene posizionato in seguito, allocando un totale di len più uno caratteri.

Valore restituito

Codice restituito Descrizione
TRUE
La stringa viene riallocata correttamente.
FALSE
Esiste memoria insufficiente.

Commenti

Alloca una nuova stringa, copia i caratteri len dalla stringa passata e quindi aggiunge un carattere Null. Libera il BSTR a cui fa riferimento attualmente da pbstr e reimposta pbstr per puntare al nuovo BSTR. Se psz è Null, viene allocata una stringa di lunghezza len ma non inizializzata.

La stringa psz può contenere caratteri Null incorporati e non deve terminare con un valore Null.

Se questa funzione viene passata un puntatore NULL, si verificherà una violazione di accesso e il programma si arresterà in modo anomalo. È responsabilità proteggere questa funzione dai puntatori NULL.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione oleauto.h
Libreria OleAut32.lib
DLL OleAut32.dll

Vedi anche

Funzioni di manipolazione delle stringhe