Fungsi SysReAllocStringLen (oleauto.h)

Membuat BSTR baru yang berisi sejumlah karakter tertentu dari BSTR lama, dan membebaskan BSTR lama.

Sintaks

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

Parameter

[in, out] pbstr

String yang dialokasikan sebelumnya.

[in, optional] psz

String tempat menyalin karakter lensa , atau NULL untuk menjaga string tetap tidak diinisialisasi.

[in] len

Jumlah karakter yang akan disalin. Karakter null ditempatkan setelahnya, mengalokasikan total lensa ditambah satu karakter.

Nilai kembali

Menampilkan kode	Deskripsi
TRUE	String berhasil dialokasikan kembali.
FALSE	Memori tidak cukup ada.

Keterangan

Mengalokasikan string baru, menyalin karakter len dari string yang diteruskan ke dalamnya, lalu menambahkan karakter null. Membebaskan BSTR yang direferensikan saat ini oleh pbstr, dan mengatur ulang pbstr untuk menunjuk ke BSTR baru. Jika psz null, untai lensa panjang dialokasikan tetapi tidak diinisialisasi.

String psz dapat berisi karakter null yang disematkan dan tidak perlu diakhir dengan null.

Jika fungsi ini diteruskan penunjuk NULL, akan ada pelanggaran akses dan program akan crash. Anda bertanggung jawab untuk melindungi fungsi ini dari pointer NULL.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	oleauto.h
Pustaka	OleAut32.lib
DLL	OleAut32.dll

Lihat juga

Fungsi Manipulasi String