Importazione delle funzioni sicure per stringhe Kernel-Mode

A partire da Windows XP, la libreria di stringhe sicure in modalità kernel è disponibile come raccolta di funzioni inline definite nel file di intestazione Ntstrsafe.h.

Per usare le funzioni delle stringhe sicure in modalità kernel

Includere il file di intestazione, come illustrato di seguito.

#include <ntstrsafe.h>

È possibile rendere disponibile solo il numero di byte o solo le funzioni di stringa sicure con conteggio dei caratteri.

Per consentire solo le funzioni con conteggio dei byte

Includere la riga seguente nel codice prima di includere il file di intestazione Ntstrsafe.h.

#define NTSTRSAFE_NO_CCH_FUNCTIONS

Per consentire solo le funzioni con conteggio dei caratteri

Includere la riga seguente nel codice prima di includere il file di intestazione Ntstrsafe.h.

#define NTSTRSAFE_NO_CB_FUNCTIONS

È possibile definire NTSTRSAFE_NO_CB_FUNCTIONS o NTSTRSAFE_NO_CCH_FUNCTIONS, ma non entrambi.

È possibile rendere non disponibili le funzioni della struttura UNICODE_STRING .

Per rendere non disponibili le funzioni di struttura UNICODE_STRING

Includere la riga seguente nel codice prima di includere il file di intestazione Ntstrsafe.h.

#define NTSTRSAFE_NO_UNICODE_STRING_FUNCTIONS

Il numero massimo di caratteri che può contenere qualsiasi stringa ANSI o Unicode è NTSTRSAFE_MAX_CCH. Il numero massimo di caratteri che una struttura UNICODE_STRING può contenere è NTSTRSAFE_UNICODE_STRING_MAX_CCH. Queste costanti sono definite in Ntstrsafe.h.

Il driver può assegnare valori più piccoli a NTSTRSAFE_MAX_CCH e NTSTRSAFE_UNICODE_STRING_MAX_CCH includendo le righe seguenti nel codice prima di includere Ntstrsafe.h.

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

Le direttive in Ntstrsafe.h verificano che i nuovi valori non siano maggiori dei valori predefiniti.