RtlInitStringEx 函式 （ntifs.h）
RtlInitStringEx 例程會初始化 8 位字元的計數位符串。
語法
NTSYSAPI NTSTATUS RtlInitStringEx(
[out] PSTRING DestinationString,
[in, optional] __drv_aliasesMem PCSZ SourceString
);
參數
[out] DestinationString
要初始化之 STRING 結構的指標。 Ntdef.h 頭檔會定義此結構，以與 ANSI_STRING 結構相同。
[in, optional] SourceString
Null 終止字元字串的指標。 此字串用來初始化 destinationString 所指向的計數位符串。
傳回值
如果 SourceString 太長，則傳回STATUS_NAME_TOO_LONG。 否則，此例程會傳回STATUS_SUCCESS。
言論
這個例程會初始化計數位符字串。
例程會將 SourceString 指標值複製到 DestinationString所指向之 STRING 結構 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。 |
| 目標平臺 | 普遍 |
| 標頭 | ntifs.h （包括 Wdm.h、Ntddk.h、Ntifs.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | 請參閱一節。 |