RtlUpcaseUnicodeStringToCountedOemString 函式 (ntifs.h)

發行項
02/29/2024

RtlUpcaseUnicodeStringToCountedOemString 例程會使用目前的系統 OEM 代碼頁，將指定的 Unicode 來源字串轉譯成大寫計數的 OEM 字符串。

語法

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToCountedOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

參數

DestinationString

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

[in] SourceString

要翻譯之 Unicode 字串的指標。

[in] AllocateDestinationString

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

傳回值

如果 RtlUpcaseUnicodeStringToCountedOemString 在 DestinationString 傳回已翻譯的字串，則會傳回STATUS_SUCCESS。否則，不會配置任何記憶體，也不會執行任何轉換。如果無法轉譯指定 SourceString中的字元，它會傳回STATUS_UNMAPPABLE_CHARACTER。