共用方式為

RtlUnicodeStringValidate 函式 （ntstrsafe.h）

  • 發行項

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

語法

NTSTRSAFEDDI RtlUnicodeStringValidate(
  [in] PCUNICODE_STRING SourceString
);

參數

[in] SourceString

要驗證之 UNICODE_STRING 結構的指標。

傳回值

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

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

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

  • SourceString->Length % sizeof（WCHAR） 不等於零。
  • SourceString->MaximumLength % sizeof（WCHAR） 不等於零。
  • SourceString->Length 大於 SourceString->MaximumLength。
  • SourceString->MaximumLength 大於 NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof（WCHAR）。
  • SourceString->Buffer 等於 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