Mengimpor Fungsi String Aman Kernel-Mode

Dimulai dengan Windows XP, pustaka string aman mode kernel tersedia sebagai kumpulan fungsi sebaris yang didefinisikan dalam file header Ntstrsafe.h.

Untuk menggunakan fungsi string aman mode kernel

Sertakan file header, seperti yang ditunjukkan.

#include <ntstrsafe.h>

Anda hanya dapat menyediakan fungsi string aman yang dihitung byte atau hanya yang dihitung karakter.

Untuk memperbolehkan hanya fungsi yang dihitung byte

Sertakan baris berikut dalam kode Anda sebelum menyertakan file header Ntstrsafe.h.

#define NTSTRSAFE_NO_CCH_FUNCTIONS

Untuk memperbolehkan hanya fungsi yang dihitung karakter

Sertakan baris berikut dalam kode Anda sebelum menyertakan file header Ntstrsafe.h.

#define NTSTRSAFE_NO_CB_FUNCTIONS

Anda dapat menentukan NTSTRSAFE_NO_CB_FUNCTIONS atau NTSTRSAFE_NO_CCH_FUNCTIONS, tetapi tidak keduanya.

Anda dapat membuat fungsi struktur UNICODE_STRING tidak tersedia.

Untuk membuat fungsi struktur UNICODE_STRING tidak tersedia

Sertakan baris berikut dalam kode Anda sebelum menyertakan file header Ntstrsafe.h.

#define NTSTRSAFE_NO_UNICODE_STRING_FUNCTIONS

Jumlah maksimum karakter yang dapat dimuat oleh string ANSI atau Unicode adalah NTSTRSAFE_MAX_CCH. Jumlah maksimum karakter yang dapat dimuat oleh struktur UNICODE_STRING adalah NTSTRSAFE_UNICODE_STRING_MAX_CCH. Konstanta ini didefinisikan dalam Ntstrsafe.h.

Driver Anda dapat menetapkan nilai yang lebih kecil untuk NTSTRSAFE_MAX_CCH dan NTSTRSAFE_UNICODE_STRING_MAX_CCH dengan menyertakan baris berikut dalam kode Anda sebelum menyertakan Ntstrsafe.h.

#define NTSTRSAFE_MAX_CCH  <new-value>
#define NTSTRSAFE_UNICODE_STRING_MAX_CCH  <new-value>

Arahan dalam Ntstrsafe.h memverifikasi bahwa nilai baru Anda tidak lebih besar dari nilai default.