Fungsi SysAllocStringByteLen (oleauto.h)

Artikel
08/25/2023

Mengambil string ANSI sebagai input, dan mengembalikan BSTR yang berisi string ANSI. Tidak melakukan terjemahan ANSI-ke-Unicode.

Sintaks

BSTR SysAllocStringByteLen(
  [in, optional] LPCSTR psz,
  [in]           UINT   len
);

Parameter

[in, optional] psz

String yang akan disalin, atau NULL untuk menjaga string tetap tidak diinisialisasi.

[in] len

Jumlah byte yang akan disalin. Karakter null ditempatkan setelahnya, mengalokasikan total len ditambah ukuran byte OLECHAR .

Menampilkan nilai

Salinan string, atau NULL jika memori tidak mencukupi untuk menyelesaikan operasi.

Keterangan

Fungsi ini disediakan untuk membuat BSTR yang berisi data biner. Anda dapat menggunakan jenis BSTR ini hanya dalam situasi di mana itu tidak akan diterjemahkan dari ANSI ke Unicode, atau sebaliknya.

Misalnya, jangan gunakan BSTR ini antara aplikasi 16-bit dan 32-bit yang berjalan pada sistem Windows 32-bit. Lapisan interoperabilitas OLE 16-bit hingga 32-bit (dan 32-bit hingga 16-bit) akan menerjemahkan BSTR dan merusak data biner. Metode yang disukai untuk meneruskan data biner adalah menggunakan SAFEARRAY VT_UI1, yang tidak akan diterjemahkan oleh OLE.

Jika psz null, string dengan panjang yang diminta dialokasikan, tetapi tidak diinisialisasi. String psz dapat berisi karakter null yang disematkan, dan tidak perlu diakhir dengan Null. Bebaskan string yang dikembalikan nanti dengan SysFreeString.

Persyaratan


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

Lihat juga

Fungsi Manipulasi String

Bagikan melalui