Fungsi RtlUnicodeStringCopyString (ntstrsafe.h)
Fungsi RtlUnicodeStringCopyString menyalin string ke dalam struktur UNICODE_STRING .
Sintaks
NTSTRSAFEDDI RtlUnicodeStringCopyString(
[out] PUNICODE_STRING DestinationString,
[in] NTSTRSAFE_PCWSTR pszSrc
);
Parameter
[out] DestinationString
Penunjuk ke struktur UNICODE_STRING yang menerima string yang disalin. String yang diacu parameter pszSrc (tidak termasuk null penghentian) disalin ke dalam buffer yang dituju oleh struktur UNICODE_STRING parameter DestinationString. Jumlah maksimum byte dalam string adalah NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
[in] pszSrc
Penunjuk ke string yang dihentikan null. String ini akan disalin ke dalam buffer yang ditunjukkan oleh struktur UNICODE_STRING parameter DestinationString.
Nilai kembali
RtlUnicodeStringCopyString mengembalikan salah satu nilai NTSTATUS berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Status keberhasilan ini berarti bahwa data sumber ada dan string disalin tanpa pemotongan. |
|
Status peringatan ini berarti bahwa operasi penyalinan tidak selesai karena ruang buffer yang tidak mencukupi. Buffer tujuan berisi versi hasil yang dipotong dan dihentikan null. |
|
Status kesalahan ini berarti bahwa fungsi menerima parameter input yang tidak valid. Untuk informasi selengkapnya, lihat daftar berikut ini. |
RtlUnicodeStringCopyString mengembalikan nilai STATUS_INVALID_PARAMETER saat salah satu hal berikut ini terjadi:
- Isi struktur UNICODE_STRING tidak valid.
- Buffer tujuan sudah penuh.
- Penunjuk buffer adalah NULL.
- Panjang buffer tujuan adalah nol, tetapi string sumber panjang bukan nol ada.
Keterangan
Fungsi RtlUnicodeStringCopyString menggunakan ukuran buffer tujuan untuk memastikan bahwa operasi penggabungan tidak menulis melewati akhir buffer. Fungsi tidak mengakhiri string yang dihasilkan dengan karakter null.
Jika string sumber dan tujuan tumpang tindih, perilaku fungsi tidak terdefinisi.
Pointer pszSrc dan DestinationString tidak boleh NULL. Jika Anda perlu menangani nilai penunjuk NULL , gunakan fungsi RtlUnicodeStringCopyStringEx .
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 | 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