Importación de funciones de cadena segura Kernel-Mode

A partir de Windows XP, la biblioteca de cadenas seguras en modo kernel está disponible como una colección de funciones insertadas que se definen en el archivo de encabezado Ntstrsafe.h.

Para usar las funciones de cadena segura en modo kernel

Incluya el archivo de encabezado, como se muestra.

#include <ntstrsafe.h>

Solo puede hacer que esté disponible el byte-counted o solo las funciones de cadena segura con recuento de caracteres.

Para permitir solo funciones con recuento de bytes

Incluya la siguiente línea en el código antes de incluir el archivo de encabezado Ntstrsafe.h.

#define NTSTRSAFE_NO_CCH_FUNCTIONS

Para permitir solo funciones con recuento de caracteres

Incluya la siguiente línea en el código antes de incluir el archivo de encabezado Ntstrsafe.h.

#define NTSTRSAFE_NO_CB_FUNCTIONS

Puede definir NTSTRSAFE_NO_CB_FUNCTIONS o NTSTRSAFE_NO_CCH_FUNCTIONS, pero no ambos.

Puede hacer que las funciones de estructura de UNICODE_STRING no estén disponibles.

Para que las funciones de estructura de UNICODE_STRING no estén disponibles

Incluya la siguiente línea en el código antes de incluir el archivo de encabezado Ntstrsafe.h.

#define NTSTRSAFE_NO_UNICODE_STRING_FUNCTIONS

El número máximo de caracteres que cualquier cadena ANSI o Unicode puede contener es NTSTRSAFE_MAX_CCH. El número máximo de caracteres que puede contener una estructura de UNICODE_STRING es NTSTRSAFE_UNICODE_STRING_MAX_CCH. Estas constantes se definen en Ntstrsafe.h.

El controlador puede asignar valores más pequeños a NTSTRSAFE_MAX_CCH y NTSTRSAFE_UNICODE_STRING_MAX_CCH mediante la inclusión de las siguientes líneas en el código antes de incluir Ntstrsafe.h.

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

Las directivas de Ntstrsafe.h comprueban que los nuevos valores no son mayores que los valores predeterminados.