RtlDowncaseUnicodeString 函式 (ntifs.h)

RtlDowncaseUnicodeString 例程會將指定的 Unicode 來源字串轉換為小寫。 翻譯符合目前的系統地區設定資訊。

語法

NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
       PUNICODE_STRING  DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

參數

DestinationString

呼叫端配置的緩衝區指標，以接收已轉換的 Unicode 字串。 如果 AllocateDestinationString 為 FALSE，呼叫端也必須為 DestinationString 的 Buffer 成員配置緩衝區，以保存 Unicode 數據。 如果 AllocateDestinationString 為 TRUE，RtlDowncaseUnicodeString 會設定足以保存字串的緩衝區、在 Buffer 中傳遞指標，並據以更新 DestinationString 的長度和最大長度成員。

[in] SourceString

要轉換成小寫的來源 Unicode 字串指標。

[in] AllocateDestinationString

如果 RtlDowncaseUnicodeString 應該配置 DestinationString 的緩衝區空間，則設定為 TRUE，否則為 FALSE。 如果此參數為 TRUE，呼叫端會負責呼叫 RtlFreeUnicodeString 不再需要緩衝區時釋放緩衝區。

傳回值

如果作業成功， RtlDowncaseUnicodeString 會傳回STATUS_SUCCESS。 否則，不會配置任何記憶體，也不會進行轉換。

備註

如果呼叫端將AllocateDestinationString 設定為TRUE，RtlDowncaseUnicodeString 會將 DestinationString 的 Buffer 成員取代為其配置的緩衝區指標。 即使例程傳回錯誤狀態代碼，也可以覆寫舊的值。

RtlDowncaseUnicodeString 不會修改來源字串。

如需其他字串處理例程的資訊，請參閱 Run-Time Library (RTL) 例程。

規格需求

另請參閱

RtlFreeUnicodeString

RtlUpcaseUnicodeString

UNICODE_STRING