Fungsi WindowsGetStringRawBuffer (winstring.h)

Mengambil buffer cadangan untuk string yang ditentukan.

Syntax

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

Parameter-parameternya

string

Jenis: [in, opsional] HSTRING

String opsional tempat buffer penopang 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 ke panjangnya ke jumlah karakter Unicode dalam buffer pendukung untuk string (termasuk karakter null yang disematkan, tetapi tidak termasuk null yang dihentikan). Jika panjang adalah penunjuk yang valid ke UINT32, dan string adalah NULL, maka nilai yang ditujukkan ke panjangnya 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.

Komentar

Gunakan fungsi WindowsGetStringRawBuffer untuk mendapatkan penunjuk ke buffer cadangan HSTRING.

Jangan mengubah konten buffer— HSTRING harus tidak dapat diubah.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Platform Target	Windows
Header	winstring.h
Library	mincore.lib