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 |
|---|---|
|
La stringa viene riallocata correttamente. |
|
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 |