Kernel-Mode biztonságos karakterlánc-függvények importálása

A Windows XP-től kezdve a kernel módú biztonságos sztringtár az Ntstrsafe.h fejlécfájlban definiált beágyazott függvények gyűjteményeként érhető el.

A kernel üzemmódú biztonságos sztringfüggvények használata

Az ábrán látható módon vegye fel a fejlécfájlt.

#include <ntstrsafe.h>

Csak a bájtszámozott vagy csak a karakterszámozott biztonságos sztringfüggvényeket teheti elérhetővé.

Csak bájtszámú függvények engedélyezése

Az Ntstrsafe.h fejlécfájl felvétele előtt adja meg a következő sort a kódban.

#define NTSTRSAFE_NO_CCH_FUNCTIONS

Csak karakterszámozott függvények engedélyezése

Az Ntstrsafe.h fejlécfájl felvétele előtt adja meg a következő sort a kódban.

#define NTSTRSAFE_NO_CB_FUNCTIONS

Definiálhat NTSTRSAFE_NO_CB_FUNCTIONS vagy NTSTRSAFE_NO_CCH_FUNCTIONS, de mindkettőt nem.

A UNICODE_STRING struktúra függvényeit elérhetetlenné teheti.

UNICODE_STRING struktúrafüggvények elérhetetlenné tétele

Az Ntstrsafe.h fejlécfájl felvétele előtt adja meg a következő sort a kódban.

#define NTSTRSAFE_NO_UNICODE_STRING_FUNCTIONS

Az ANSI- vagy Unicode-sztring tartalmazható maximális karakterszáma az NTSTRSAFE_MAX_CCH. A UNICODE_STRING struktúra legfeljebb NTSTRSAFE_UNICODE_STRING_MAX_CCH karakterek számát tartalmazhatja. Ezek az állandók az Ntstrsafe.h-ban vannak definiálva.

Az illesztőprogram kisebb értékeket rendelhet az NTSTRSAFE_MAX_CCH és az NTSTRSAFE_UNICODE_STRING_MAX_CCH számára azáltal, hogy az Ntstrsafe.h hozzáadása előtt a következő sorokat beilleszti a kódba.

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

Az Ntstrsafe.h irányelvei ellenőrzik, hogy az új értékek nem nagyobbak-e az alapértelmezett értékeknél.