Fungsi RtlStringCchLengthW (ntstrsafe.h)

  • Artikel

Fungsi RtlStringCchLengthW dan RtlStringCchLengthA menentukan panjang, dalam karakter, dari string yang disediakan.

Sintaks

NTSTRSAFEDDI RtlStringCchLengthW(
  [in] STRSAFE_PCNZWCH psz,
  [in] size_t          cchMax,
       size_t          *pcchLength
);

Parameter

[in] psz

Penunjuk ke buffer yang berisi string yang dihentikan null, yang panjangnya akan diperiksa.

[in] cchMax

Jumlah maksimum karakter yang diizinkan dalam buffer yang diacu oleh psz, termasuk karakter null yang mengakhiri. Nilai ini tidak boleh melebihi NTSTRSAFE_MAX_CCH.

pcchLength

Jika penelepon menyediakan penunjuk alamat non-NULL , fungsi memuat alamat dengan panjang, dalam karakter, dari string yang terkandung dalam buffer. Panjang tidak termasuk karakter null yang mengakhiri string.

Menampilkan nilai

Fungsi mengembalikan salah satu nilai NTSTATUS yang tercantum dalam tabel berikut. Untuk informasi tentang cara menguji nilai NTSTATUS, lihat Menggunakan Nilai NTSTATUS.

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Status keberhasilan ini berarti string pada psz bukan NULL, dan panjang string (termasuk karakter null yang mengakhiri) kurang dari atau sama dengan karakter cchMax .
STATUS_INVALID_PARAMETER
 Status kesalahan ini berarti nilai dalam psz adalah NULL, cchMax lebih besar dari NTSTRSAFE_MAX_CCH, atau psz lebih panjang dari cchMax.

Keterangan

RtlStringCchLengthW dan RtlStringCchLengthA harus digunakan alih-alih strlen. Mereka digunakan untuk memastikan bahwa string tidak lebih besar dari panjang tertentu, dalam karakter. Jika kondisi tersebut terpenuhi, RtlStringCchLengthW dan RtlStringCchLengthA mengembalikan panjang string saat ini dalam karakter, tidak termasuk karakter null yang mengakhiri.

Gunakan RtlStringCchLengthW untuk menangani string Unicode dan RtlStringCchLengthA untuk menangani string ANSI. Formulir yang Anda gunakan bergantung pada data Anda, seperti yang diperlihatkan dalam tabel berikut ini.

Jenis data string String literal Fungsi
WCHAR L"string" RtlStringCchLengthW
char "string" RtlStringCchLengthA
 

Untuk informasi selengkapnya tentang fungsi string aman, lihat Menggunakan Fungsi String Aman.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows XP dengan Paket Layanan 1 (SP1) dan versi Windows yang lebih baru.
Target Platform Desktop
Header ntstrsafe.h (termasuk Ntstrsafe.h)
Pustaka Ntstrsafe.lib
IRQL Bagaimanapun, jika string yang dimanipulasi selalu berada dalam memori, jika tidak, PASSIVE_LEVEL

Lihat juga

RtlStringCbLength