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