Fungsi RtlStringCchCatNA (ntstrsafe.h)
Fungsi RtlStringCchCatNW dan RtlStringCchCatNA menggabungkan dua string yang dihitung karakter sambil membatasi ukuran string yang ditambahkan.
Sintaks
NTSTRSAFEDDI RtlStringCchCatNA(
[in, out] NTSTRSAFE_PSTR pszDest,
[in] size_t cchDest,
[in] STRSAFE_PCNZCH pszSrc,
size_t cchToAppend
);
Parameter
[in, out] pszDest
Penunjuk ke buffer yang, pada input, berisi string yang dihentikan null di mana pszSrc akan digabungkan. Pada output, ini adalah buffer tujuan yang berisi seluruh string yang dihasilkan. String di pszSrc, hingga karakter cchMaxAppend , ditambahkan ke akhir string di pszDest dan dihentikan dengan karakter null.
[in] cchDest
Ukuran buffer tujuan, dalam karakter. Jumlah maksimum karakter yang diperbolehkan adalah NTSTRSAFE_MAX_CCH.
[in] pszSrc
Penunjuk ke string yang dihentikan null. String ini akan digabungkan ke akhir string yang terkandung dalam buffer di pszDest.
cchToAppend
Jumlah maksimum karakter untuk ditambahkan ke string yang terkandung dalam buffer di pszDest.
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 keberhasilan ini berarti data sumber ada, string digabungkan tanpa pemotongan, dan buffer tujuan yang dihasilkan dihentikan null. |
|
Status peringatan ini berarti operasi penggabungan tidak selesai karena ruang buffer yang tidak mencukup. Buffer tujuan berisi versi hasil yang dipotong dan dihentikan null. |
|
Status kesalahan ini berarti fungsi menerima parameter input yang tidak valid. Untuk informasi selengkapnya, lihat paragraf berikut ini.
Fungsi mengembalikan nilai STATUS_INVALID_PARAMETER saat:
|
Keterangan
RtlStringCchCatNW dan RtlStringCchCatNA harus digunakan alih-alih fungsi berikut:
- strncat
- wcsncat
Gunakan RtlStringCchCatNW untuk menangani string Unicode dan RtlStringCchCatNA untuk menangani string ANSI. Formulir yang Anda gunakan bergantung pada data Anda, seperti yang diperlihatkan dalam tabel berikut ini.
Jenis data string | String harfiah | Fungsi |
---|---|---|
WCHAR | L"string" | RtlStringCchCatNW |
Char | "string" | RtlStringCchCatNA |
Jika pszSrc dan pszDest menunjuk ke string yang tumpang tindih, perilaku fungsi tidak terdefinisi.
Baik pszSrc maupun pszDest tidak boleh NULL. Jika Anda perlu menangani nilai penunjuk string NULL , gunakan RtlStringCchCatNEx.
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk