共用方式為

RtlUnicodeStringValidateEx 函式 （ntstrsafe.h）

  • 發行項

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

語法

NTSTRSAFEDDI RtlUnicodeStringValidateEx(
  [in] PCUNICODE_STRING SourceString,
  [in] DWORD            dwFlags
);

參數

[in] SourceString

自選。 要驗證之 UNICODE_STRING 結構的指標。 此指標可以 NULL，但只有在 dwFlags中設定STRSAFE_IGNORE_NULLS時。

[in] dwFlags

定義下列旗標：

STRSAFE_IGNORE_NULLS

如果設定此旗標，來源指標可以 NULL。 RtlUnicodeStringValidateEx 會 NULL 來源緩衝區指標，例如空字串（TEXT（“”））。

傳回值

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

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

如果未在 dwFlags 中設定STRSAFE_IGNORE_NULLS，RtlUnicodeStringValidateEx 會在發生下列其中一項時傳回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 不等於零。
  • dwFlags指定無效的旗標。
如需如何測試 NTSTATUS 值的資訊，請參閱使用 NTSTATUS 值 。

言論

除非設定STRSAFE_IGNORE_NULLS旗標，否則 SourceString 指標無法 NULL。

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

要求

要求 價值
最低支援的用戶端 Windows XP 中提供 Service Pack 1 （SP1） 和更新版本的 Windows。
目標平臺 桌面
標頭 ntstrsafe.h （包括 Ntstrsafe.h）
連結庫 Ntstrsafe.lib
IRQL 如果所作的字串一律位於記憶體中，則為任何 ，否則PASSIVE_LEVEL

另請參閱

RtlUnicodeStringValidate

UNICODE_STRING