Fungsi RtlInitializeSid (ntifs.h)

  • Artikel

RtlInitializeSid rutin menginisialisasi struktur pengidentifikasi keamanan (SID).

Sintaks

NTSYSAPI NTSTATUS RtlInitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY IdentifierAuthority,
  [in]  UCHAR                     SubAuthorityCount
);

Parameter

[out] Sid

Penunjuk ke struktur SID yang dialokasikan penelepon untuk diinisialisasi.

[in] IdentifierAuthority

Arahkan ke struktur SID_IDENTIFIER_AUTHORITY untuk diatur dalam struktur SID.

[in] SubAuthorityCount

Jumlah subotoritas yang akan diatur dalam SID. Nilai subautoritas harus diatur secara terpisah, seperti yang dijelaskan di bagian Keterangan berikut.

Nilai kembali

RtlInitializeSid mengembalikan salah satu hal berikut ini:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 SID berhasil diinisialisasi.
STATUS_INVALID_PARAMETER
 Nilai SubAuthorityCount yang ditentukan tidak valid.

Keterangan

Meskipun RtlInitializeSid menetapkan jumlah subautoritas untuk SID, RtlInitializeSid tidak mengatur nilai subautoritas. Ini harus dilakukan secara terpisah dengan memanggil RtlSubAuthoritySid.

Untuk informasi selengkapnya tentang keamanan dan kontrol akses, lihat Model keamanan Windows untuk pengembang driver dan dokumentasi tentang topik ini di Windows SDK.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe (mode kernel); Ntdll.dll (mode pengguna)
IRQL < DISPATCH_LEVEL

Lihat juga

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY