Condividi tramite

Importazione di funzioni stringa sicure Kernel-Mode

  • Articolo

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

Per usare le funzioni stringa sicure in modalità kernel

Includere il file di intestazione, come illustrato.

#include <ntstrsafe.h>

È possibile rendere disponibili solo le funzioni di stringa sicure con conteggio dei caratteri o solo i byte.you can available only the byte-counted string functions.

Per consentire solo funzioni con conteggio byte

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

#define NTSTRSAFE_NO_CCH_FUNCTIONS

Per consentire solo funzioni con conteggio 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 di 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 qualsiasi stringa ANSI o Unicode può contenere è 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 verificare che i nuovi valori non siano maggiori dei valori predefiniti.