共用方式為

RtlUnicodeStringValidate 函式 (ntstrsafe.h)

  • 發行項

RtlUnicodeStringValidate 函式會驗證UNICODE_STRING結構的內容。

語法

NTSTRSAFEDDI RtlUnicodeStringValidate(
  [in] PCUNICODE_STRING SourceString
);

參數

[in] SourceString

要驗證 之UNICODE_STRING 結構的指標。

傳回值

RtlUnicodeStringValidate 會傳回下列其中一個 NTSTATUS 值。

傳回碼 Description
STATUS_SUCCESS
 此 成功 狀態表示函式已順利完成。
STATUS_INVALID_PARAMETER
 這個 錯誤 狀態表示函式收到無效的輸入參數。 如需詳細資訊，請參閱下列清單。
 

當發生下列其中一項時，RtlUnicodeStringValidate 會傳回STATUS_INVALID_PARAMETER值：

  • SourceString->長度 % sizeof (WCHAR) 不等於零。
  • SourceString->MaximumLength % sizeof (WCHAR) 不等於零。
  • SourceString->長度 大於 SourceString->MaximumLength。
  • SourceString->MaximumLength 大於 NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof (WCHAR) 。
  • SourceString->緩衝區 等於 NULL ，但 SourceString->Length 或 SourceString->MaximumLength 不等於零。
如需如何測試 NTSTATUS 值的詳細資訊，請參閱 使用NTSTATUS值。

備註

SourceString 指標不可為 NULL。 如果您需要指定 NULL 指標值，請使用 RtlUnicodeStringValidateEx 函式。

如需安全字串函式的詳細資訊，請參閱 使用安全字串函式。

規格需求

需求 值
最低支援的用戶端 在 Windows XP 中使用 Service Pack 1 (SP1) 和更新版本的 Windows。
目標平台 桌面
標頭 ntstrsafe.h (包含 Ntstrsafe.h)
程式庫 Ntstrsafe.lib
IRQL 如果正在操作的字串一律位於記憶體中，則為任何 ，否則PASSIVE_LEVEL

另請參閱

RtlUnicodeStringValidateEx

UNICODE_STRING