Windows内核字符串的操作（基础，但是很重要）

内核模式下的字符串操作
1、ASCII字符串和宽字符串
在驱动程序开发中，DDK将char和wchar_t类别，替换成CHAR和WCHAR类别
驱动程序中用KdPrint打印ASCII字符串和宽字符串：
打印ASCII字符串

CHAR *string = "Hello";KdPrint("%s\n", string);

打印宽字符串

WCHAR *string = L"Hello";KdPrint("%S\n", string);

2、ANSI_STRING字符串与UNICODE_STRING字符串
2.1、ANSI_STRING字符串：

typedef struct _STRING{    USHORT Length;    USHORT MaximumLength;    PCHAR Buffer;}STRING;typedef STRING ANSI_STRING;typedef PSTRING PANSI_STRING;typedef STRING OEM_STRING;typedef PSTRING POEM_STRING;

这个数据结构对ASCII字符串进行了封装
Length:字符的长度
MaximumLength:整个字符串缓冲区的最大长度
Buffer:缓冲区的指针
注意：和标准的字符不同，STRING字符串不是以0标志字符的结束。字符长度依靠
Length字段。在标准C中的字符串中，如果缓冲区长度是N，那么只能容纳N-1个字
符的字符串，这是因为要留一个字节存储NULL。而在STRING字符串中，缓冲区的大小
MaximumLength，最大的字符串长度可以是MaximumLength，而不是MaximumLength-1

2.2、UNICODE_STRING字符串：

typedef struct _UNICODE_STRING{    USHORT Length;    USHORT MaxmumLength;    PWSTR Buffer;} UNICODE_STRING;

Length:字符的长度,单位是字节。如果是N个字符，那么Length等于N的2倍
MaximumLength:整个字符串缓冲区的最大长度，单位也是字节
Buffer:缓冲区的指针

2.3、KdPrint打印ANSI_STRING字符串与UNICODE_STRING字符串
打印ANSI_STRING字符串:

ANSI_STRING ansiString;//省去对ansiString初始化KdPrint("%Z\n", &ansiString);打印UNICODE_STRING字符串:UNICODE_STRING uniString;//省去对uniString初始化KdPrint("%wZ\n", &uniString);

3、字符串的初始化与销毁
3.1、方法一使用DDK提供了相应的函数

/************************************************************************* 函数名称:RtlInitAnsiString* 功能描述:初始化ANSI_STRING字符串* 参数列表:        DestinationString:要初始化的ANSI_STRING字符        SourceString:字符串的内容* 返回 值:VOID*************************************************************************/VOID RtlInitAnsiString(    IN OUT PANSI_STRING DestinationString,    IN PCSZ SourceString)

使用方法：

ANSI_STRING AnsiString1;CHAR* string1 = "hello";RtlInitAnsiString(&AnsiString1,string1); 

/************************************************************************* 函数名称:RtlInitUnicodeString* 功能描述:初始化UNICODE_STRING字符串* 参数列表:        DestinationString:要初始化的UNICODE_STRING字符        SourceString:字符串的内容* 返回 值:VOID*************************************************************************/VOID RtlInitUnicodeString(    IN OUT PANSI_STRING DestinationString,    IN PCSZ SourceString)

使用方法：

UNICODE_STRING UniString1;CHAR* string1 = "hello";RtlInitUnicodeString(&UniString1,string1); 

这中办法是将AnsiString1中的Buffer等于string1指针。这种初始化的优点是
操作简单，用完后不用清理内存。但带来另外一个问题，如果修改string1,同时
会导致AnsiString1字符串发生变化

ANSI_STRING AnsiString1;CHAR* string1 = "hello";//初始化ANSI_STRING字符串RtlInitAnsiString(&AnsiString1,string1); KdPrint(("AnsiString1:%Z\n", &AnsiString1));//打印hello//改变string1string1[0]='H';string1[1]='E';string1[2]='L';string1[3]='L';string1[4]='o';//改变string1,AnsiString1同样会导致变化KdPrint(("AnsiString1:%Z\n", &AnsiString1));//打印HELLO

3.1、另外一种方法是程序员自己申请内存，并初始化内存，当不用字符串时
需要回收字符串占用的内存

#define BUFFER_SIZE 1024UNICODE_STRING UnicodeString1 = {0};//设置缓冲区大小UnicodeString1.MaximumLength = BUFFER_SIZE;//分配内存UnicodeString1.Buffer = (PWSTR)ExAllocatePool(PagedPool, BUFFER_SIZE);WCHAR* wideString = L"hello";//设置字符串长度，因为是宽字符，所以是字符长度的2倍UnicodeString1.Length = 2 * wcslen(wideString);//保证缓冲区足够大，否则程序终止ASSERT(UnicodeString1.MaximumLength >= UnicodeString1.Length);//内存赋值RtlCopyMemory(UnicodeString1.Buffer, wideString, UnicodeString1.Length);KdPrint(("UnicodeString:%wZ\n", &UnicodeString1));//清理内存ExFreePool(UnicodeString1.Buffer);UnicodeString1.Buffer = NULL;UnicodeString1.Length = UnicodeString1.MaximumLength = 0;

清理内存，DDK同样给出了简化函数分别是

RtlFreeAnsiStringRtlFreeUnicodeString

这两个函数内部调用了ExFreePool去回收内存

4、字符串复制

/************************************************************************* 函数名称:RtlCopyString* 功能描述:ANSI_STRING字符串复制* 参数列表:        DestinationString:目的字符串        SourceString:源字符串* 返回 值:VOID*************************************************************************/VOID RtlCopyString(    IN OUT PSTRING DestinationString,    IN PSTRING SourceString OPTIONAL);/************************************************************************* 函数名称:RtlCopyUnicodeString* 功能描述:UNICODE_STRING字符串复制* 参数列表:        DestinationString:目的字符串        SourceString:源字符串* 返回 值:VOID*************************************************************************/VOID RtlCopyUnicodeString(    IN OUT PUNICODE_STRING DestinationString,    IN PUNICODE_STRING SourceString OPTIONAL);

使用方法：

//初始化UnicodeString1UNICODE_STRING UnicodeString1;RtlInitUnicodeString(&UnicodeString1, L"Hello World");//初始化UnicodeString2UNICODE_STRING UnicodeString2 = {0};UnicodeString2.Buffer = (PWSTR)ExAllocatePool(PagedPool, BUFFER_SIZE);UnicodeString2.MaximumLength = BUFFER_SIZE;//将初始化UnicodeString1复制到UnicodeString2RtlCopyUnicodeString(&UnicodeString2, &UnicodeString1);//分别显示UnicodeString1和UnicodeString2KdPrint(("UnicodeString1%wZ\n", &UnicodeString1));KdPrint(("UnicodeString2%wZ\n", &UnicodeString2));//销毁UnicodeString2//注意UnicodeString1不用销毁RtlFreeUnicodeString(&UnicodeString2);

 

 5、字符串比较

/************************************************************************* 函数名称:RtlCompareString* 功能描述:ANSI_STRING字符串比较* 参数列表:        String1:要比较的第一个字符串        String2:要比较的第二个字符串        CaseInSensitive:是否对大小写敏感* 返回 值:比较结果        如果函数返回值为0，表示两个字符串相等        如果小于0，则表示第一个字符串小于第二个字符串        如果大于0，则表示第一个字符串大于第二个字符串*************************************************************************/LONG RtlCompareString(    IN PSTRING String1,    IN PSTRING String2,    IN BOOLEAN CaseInSensitive);/************************************************************************* 函数名称:RtlCompareUnicodeString* 功能描述:UNICODE_STRING字符串比较* 参数列表:        String1:要比较的第一个字符串        String2:要比较的第二个字符串        CaseInSensitive:是否对大小写敏感* 返回 值:比较结果        如果函数返回值为0，表示两个字符串相等        如果小于0，则表示第一个字符串小于第二个字符串        如果大于0，则表示第一个字符串大于第二个字符串*************************************************************************/LONG RtlCompareUnicodeString(    IN PUNICODE_STRING String1,    IN PUNICODE_STRING String2,    IN BOOLEAN CaseInSensitive);

如何使用RtlCompareUnicoodeString函数

UNICODE_STRING UnicodeString2;RtlInitUnicodeString(&UnicodeString2, L"Hello");//判断字符串是否相等if(RtlEqualUnicodeString(&UnicodeString1, &UnicodeString2, TRUE)){    KdPrint(("UnicodeString1 and UnicodeString2 are equal\n"));}else{    KdPrint(("UnicodeString1 and UnicodeString2 are NOT equal\n"));}

6、字符串转化成大写

/************************************************************************* 函数名称:RtlUpperString* 功能描述:UNICODE_STRING字符串转化成大写* 参数列表:        DestinationString:目的字符串        SourceString:源字符串* 返回 值:VOID*************************************************************************/VOID RtlUpperString(    IN OUT PSTRING DestinationString,    IN PSTRING SourceString);/************************************************************************* 函数名称:RtlUpperString* 功能描述:UNICODE_STRING字符串转化成大写* 参数列表:        DestinationString:目的字符串        SourceString:源字符串        AllocateDesttinationString:是否为目的字符串分配内存* 返回 值:VOID*************************************************************************/NTSTATUS RtlUpcaseUnicodeString(    IN OUT PUNICODE_STRING DestinationString OPTIONAL,    IN PCUNICODE_STRING SourceString,    IN BOOLEAN AllocateDesttinationString);

如何使用RtlUpcaseUnicodeString函数

//初始化UnicodeString1UNICODE_STRING UnicodeString1;RtlInitUnicodeString(&UnicodeString1, L"Hello World");//变化钱KdPrint(("UnicodeString1:%wZ\n", &UnicodeString1));//转换成大写RtlUpcaseUnicodeString(&UnicodeString1,&UnicodeString2,FALSE);//变化后KdPrint(("UnicodeString1:%wZ\n", &UnicodeString1));

 

 7、字符串与整型数字相互转换

 

/************************************************************************* 函数名称:RtlUnicodeStringToInteger* 功能描述:UNICODE_STRING字符串转化成整型数字* 参数列表:        String:需要转化的字符串        Base:转换的数的进制(2,8,10,16)        Value:需要转换的数字* 返回 值:指明是否转换成功*************************************************************************/NTSTATUS RtlUnicodeStringToInteger(IN PUNICODE_STRING String,IN ULONG Base OPTIONAL,OUT PULONG Value);/************************************************************************* 函数名称:RtlIntegerToUnicodeString* 功能描述:UNICODE_STRING字符串转化成整型数字* 参数列表:        Value:需要转化的数字        Base:转换的数的进制(2,8,10,16)        String:需要转换的字符串* 返回 值:指明是否转换成功*************************************************************************/NTSTATUS RtlIntegerToUnicodeString(IN ULONG Value,IN ULONG Base OPTIONAL,OUT PUNICODE_STRING  String);

 

字符串与整型数字相互转换的实例

//(1)字符串转换成数字//初始化UnicodeString1UNICODE_STRING UnicodeString1;RtlInitUnicodeString(&UnicodeString1, L"-100");ULONG lNumber;NTSTATUS nStatus = RtlUnicodeStringToInteger(&UnicodeString1, 10, &lNumber);if( NT_SUCCESS(nStatus) ){    KdPrint(("Conver To Integer successfullu!\n"));    KdPrint(("Result:%d\n", lNumber));}else{    KdPrint(("Conver to integer unsuccessfully!\n"));}//(2)数字转换成字符串//初始化UnicodeString2UNICODE_STRING UnicodeString2;UnicodeString2.Buffer = (PWSTR)ExAllocatePool(PagedPool, BUFFER_SIZE);UnicodeString2.MaximumLength = BUFFER_SIZE;nStatus = RtlIntegerToUnicodeString(200, 10, &UnicodeString2);if( NT_SUCCESS(nStatus) ){    KdPrint(("Conver to string successfuall!\n"));    KdPrint(("Result:%wZ\n", &UnicodeString2));}else{    KdPrint(("Conver to string unsuccessfully!\n"));}//注销UniocdeString2//注意：UnicodeString1不用销毁RtlFreeUnicodeString(&UniocdeString2);

 

 

 8、ANSI_STRING字符串与UNICODE_STRING字符串相互转换

 

/************************************************************************* 函数名称:RtlUnicodeStringToAnsiString* 功能描述:将UNICODE_STRING字符串转化成ANSI_STRING字符串* 参数列表:        DestinationString:需要转化的字符串        SourceString:需要转换的原字符串        AllocateDesctinationString:是否需要对被转换的字符串分配内存* 返回 值:指明是否转换成功*************************************************************************/NTSTATUS RtlUnicodeStringToAnsiString(INT OUT PANSI_STRING DestinationString,IN PUNICODE_STRING SourceString,IN BOOLEAN AllocateDesctinationString);/************************************************************************* 函数名称:RtlAnsiStringToUnicodeString* 功能描述:将ANSI_STRING字符串转化成UNICODE_STRING字符串* 参数列表:        DestinationString:需要转化的字符串        SourceString:需要转换的原字符串        AllocateDesctinationString:是否需要对被转换的字符串分配内存* 返回 值:指明是否转换成功*************************************************************************/NTSTATUS RtlAnsiStringToUnicodeString(INT OUT PUNICODE_STRING DestinationString,IN PANSI_STRING SourceString,IN BOOLEAN AllocateDesctinationString);

 

ANSI_STRING字符串与UNICODE_STRING字符串的相互转换

//(1)将UNICODE_STRING字符串转换成ANSI_STRING字符串//初始化UnicodeString1UNICODE_STRING UnicodeString1;RtlInitUnicodeString(&UnicodeString1, L"Hello World");ANSI_STRING AnsiString1;NTSTATUS nStatus = RtlUnicodeStringToAnsiString(&AnsiString1, &UnicodeString1, TRUE);if( NT_SUCCESS(nStatus) ){    KdPrint(("Conver successfully!\n"));    KdPrint(("Result:%Z\n", &AnsiString1));}else{    KdPrint(("Conver unsuccessfully\n"));}//销毁AnsiString1RtlFreeAnsiString(&AnsiString1);//(2)将ANSI_STRIN字符串转换成GUNICODE_STRING字符串//初始化AnsiString2ANSI_STRING AnsiString2;RtlInitString(&AnsiString2, "Hello World");UNICODE_STRING UnicodeString2;nStatus = RtlAnsiStringToUnicodeString(&UnicodeString2, &AnsiString2, TRUE);if( NT_SUCCESS(nStatus) ){    KdPrint(("Conver successfully!\n"));    KdPrint(("Result:%Z\n", &UnicodeString2));}else{    KdPrint(("Conver unsuccessfully\n"));}//销毁UnicodeString2RtlFreeUnicodeString(&UnicodeString2);