RtlInitUnicodeString

最新推荐文章于 2024-09-25 22:09:56 发布

翻译最新推荐文章于 2024-09-25 22:09:56 发布 · 3.2k 阅读

文章标签：

#string #structure #buffer #comments #include #null

WDK Document 专栏收录该内容

12 篇文章

订阅专栏

本文介绍了RtlInitUnicodeString函数的功能与用法，该函数用于初始化Unicode字符串。文章详细解释了参数的意义，并指出了调用该函数时的IRQL要求。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

RtlInitUnicodeString

The RtlInitUnicodeString routine initializes a counted Unicode string.

VOID
RtlInitUnicodeString(
    IN OUT PUNICODE_STRING DestinationString ,
    IN PCWSTR SourceString
    );

Parameters

DestinationString

Pointer to the UNICODE_STRING structure to be initialized.

SourceString

Pointer to a null-terminated Unicode string with which to initialize the counted string.

Return Value

None

Comments

The Buffer member of DestinationString is initialized to point to SourceString . The length and maximum length for DestinationString are initialized to the length of SourceString . If SourceString is NULL, the length is zero.

Callers of RtlInitUnicodeString can be running at IRQL <= DISPATCH_LEVEL if the DestinationString buffer is nonpageable. Usually, callers run at IRQL = PASSIVE_LEVEL because most other Rtl Xxx String routines cannot be called at IRQL > PASSIVE_LEVEL.