Penggunaan Buffer String

Fungsi yang mengembalikan string berisi parameter input, lpszBuffer, dan parameter ukuran, lpdwBufferLength. Meskipun lpszBuffer dapat NULL, lpdwBufferLength harus merupakan penunjuk valid ke variabel DWORD. Jika buffer input yang ditunjukkan oleh lpszBuffernull atau terlalu kecil untuk menahan string output, fungsi gagal dan GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER. Variabel yang ditunjukkan oleh lpdwBufferLength berisi angka yang menunjukkan jumlah byte yang dibutuhkan fungsi untuk mengembalikan string yang diminta, termasuk karakter penanda akhir null. Aplikasi harus mengalokasikan buffer dengan ukuran ini, menetapkan variabel yang ditunjuk oleh lpdwBufferLength ke nilai ini, dan mengirimkan ulang permintaan. Jika ukuran buffer cukup untuk menerima string yang diminta, string disalin ke buffer output dengan terminator null dan fungsi mengembalikan indikasi keberhasilan. Variabel yang diarahkan oleh lpdwBufferLength sekarang berisi jumlah karakter yang disimpan dalam buffer, tidak termasuk terminator null.