Fungsi RtlUnicodeStringValidate (ntstrsafe.h)

  • Artikel

Fungsi RtlUnicodeStringValidate memvalidasi konten struktur UNICODE_STRING .

Sintaks

NTSTRSAFEDDI RtlUnicodeStringValidate(
  [in] PCUNICODE_STRING SourceString
);

Parameter

[in] SourceString

Penunjuk ke struktur UNICODE_STRING yang akan divalidasi.

Menampilkan nilai

RtlUnicodeStringValidate mengembalikan salah satu nilai NTSTATUS berikut.

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Status keberhasilan ini berarti bahwa fungsi berhasil diselesaikan.
STATUS_INVALID_PARAMETER
 Status kesalahan ini berarti bahwa fungsi menerima parameter input yang tidak valid. Untuk informasi selengkapnya, lihat daftar berikut ini.
 

RtlUnicodeStringValidate mengembalikan nilai STATUS_INVALID_PARAMETER ketika salah satu hal berikut ini terjadi:

  • SourceString->Panjang % sizeof(WCHAR) tidak sama dengan nol.
  • SourceString->MaximumLength % sizeof(WCHAR) tidak sama dengan nol.
  • SourceString->Panjang lebih besar dari SourceString->MaximumLength.
  • SourceString->MaximumLength lebih besar dari NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof(WCHAR).
  • SourceString->Buffer sama dengan NULL tetapi Panjang SourceString-> atau SourceString->MaximumLength tidak sama dengan nol.
Untuk informasi tentang cara menguji nilai NTSTATUS, lihat Menggunakan Nilai NTSTATUS.

Keterangan

Penunjuk SourceString tidak boleh NULL. Jika Anda perlu menentukan nilai penunjuk NULL , gunakan fungsi RtlUnicodeStringValidateEx .

Untuk informasi selengkapnya tentang fungsi string aman, lihat Menggunakan Fungsi String Aman.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows XP dengan Paket Layanan 1 (SP1) dan versi Windows yang lebih baru.
Target Platform Desktop
Header ntstrsafe.h (termasuk Ntstrsafe.h)
Pustaka Ntstrsafe.lib
IRQL Bagaimanapun, jika string yang dimanipulasi selalu berada dalam memori, jika tidak, PASSIVE_LEVEL

Lihat juga

RtlUnicodeStringValidateEx

UNICODE_STRING