共用方式為

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 指向的計數位符串。

傳回值

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

言論

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

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

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

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

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

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

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

要求

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

另請參閱

ANSI_STRING