RtlInitUTF8StringEx 函式 (ntifs.h)

  • 發行項

RtlInitUTF8StringEx 初始化 UTF-8 字元的計數位符串。

語法

NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
  PUTF8_STRING          DestinationString,
  __drv_aliasesMem PCSZ SourceString
);

參數

DestinationString

要初始化UTF8_STRING結構的指標。 ntdef.h 頭檔定義此結構，與ANSI_STRING結構相同。

SourceString

Null 終止字元字串的指標。 SourceString 可用來初始化 DestinationString 所指向的計數位符串。

傳回值

如果 SourceString 太長，RtlInitUTF8StringEx 會傳回STATUS_NAME_TOO_LONG。 否則，這個例程會傳回STATUS_SUCCESS。

備註

RtlInitUTF8StringEx 會設定 DestinationString 指向之UTF8_STRING結構的成員，如下所示：

  • 將 SourceString 的指標值複製到 Buffer 成員。

  • 將 Length 成員設定為來源字串的長度，以位元組為單位，不包括終止 Null。

  • 將 MaximumLength 成員設定為來源字元串的長度，以位元組為單位，包括終止 Null。

如果 SourceString 為 NULL，Length 和 MaximumLength 都會設定為零。

RtlInitStringEx 不會改變 SourceString指向的來源字串。

如果 DestinationString 緩衝區不可分頁，RtlInitStringEx 的呼叫端可以在 IRQL <= DISPATCH_LEVEL執行。 通常，呼叫端會在 IRQL = PASSIVE_LEVEL執行，因為大部分的其他 RtlXxx字串 例程無法在 IRQL > PASSIVE_LEVEL呼叫。

規格需求

需求 值
最低支援的用戶端 Windows 10 (版本 2004)
標頭 ntifs.h

另請參閱

ANSI_STRING