Fungsi WindowsGetStringRawBuffer (winstring.h)

Artikel
08/27/2023

Mengambil buffer cadangan untuk string yang ditentukan.

Sintaks

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

Parameter

string

Jenis: [in, opsional] HSTRING

String opsional tempat buffer dukungan akan diambil. Bisa NULL.

length

Jenis: [out, opsional] UINT32 *

Penunjuk opsional ke UINT32. Jika NULL diteruskan untuk panjangnya, null akan diabaikan. Jika panjang adalah penunjuk yang valid ke UINT32, dan string adalah HSTRING yang valid, maka pada penyelesaian yang berhasil, fungsi mengatur nilai yang diarahkan panjangnya ke jumlah karakter Unicode dalam buffer pendukung untuk string (termasuk karakter null yang disematkan, tetapi tidak termasuk null yang dihentikan). Jika panjangnya adalah penunjuk yang valid ke UINT32, dan string adalah NULL, maka nilai yang ditujukkan menurut panjang diatur ke 0.

Mengembalikan nilai

Jenis: PCWSTR

Penunjuk ke buffer yang menyediakan penyimpanan cadangan untuk string, atau string kosong jika stringadalah NULL atau string kosong.

Keterangan

Gunakan fungsi WindowsGetStringRawBuffer untuk mendapatkan penunjuk ke buffer backing HSTRING.

Jangan mengubah konten buffer— HSTRING harus tidak dapat diubah.

Persyaratan


Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winstring.h

Bagikan melalui