Fungsi ObGetObjectSecurity (wdm.h)

  • Artikel

Rutinitas ObGetObjectSecurity mendapatkan deskriptor keamanan untuk objek tertentu.

Sintaks

NTSTATUS ObGetObjectSecurity(
  [in]  PVOID                Object,
  [out] PSECURITY_DESCRIPTOR *SecurityDescriptor,
  [out] PBOOLEAN             MemoryAllocated
);

Parameter

[in] Object

Arahkan ke objek .

[out] SecurityDescriptor

Penunjuk ke variabel yang disediakan penelepon yang disetel rutin ini ke alamat buffer yang berisi SECURITY_DESCRIPTOR untuk objek yang diberikan. Jika objek yang diberikan tidak memiliki deskriptor keamanan, variabel ini diatur ke NULL saat dikembalikan dari ObGetObjectSecurity.

[out] MemoryAllocated

Penunjuk ke variabel yang disediakan penelepon yang rutin ini diatur ke TRUE jika mengalokasikan buffer untuk berisi deskriptor keamanan.

Nilai kembali

ObGetObjectSecurity mengembalikan STATUS_SUCCESS atau status kesalahan, seperti STATUS_INSUFFICIENT_RESOURCES jika tidak dapat mengalokasikan memori yang cukup untuk mengembalikan informasi yang diminta.

Keterangan

Panggilan yang berhasil ke ObGetObjectSecurity mengembalikan deskriptor keamanan relatif mandiri dalam buffer di *SecurityDescriptor atau mengembalikan NULL di *SecurityDescriptor jika objek yang diberikan tidak memiliki deskriptor keamanan. Misalnya, objek yang tidak disebutkan namanya, seperti objek peristiwa, tidak memiliki deskriptor keamanan.

Jika ObGetObjectSecurity mengembalikan STATUS_SUCCESS, pemanggil harus menyimpan nilai yang dikembalikan di MemoryAllocated. Penelepon semacam itu harus meneruskan MemoryAllocated dalam panggilan timbal balik ke ObReleaseObjectSecurity pada akhirnya, sehingga memulihkan jumlah referensi pada deskriptor keamanan ke nilai aslinya dan melepaskan buffer, jika ada, yang dialokasikan oleh ObGetObjectSecurity.

ObGetObjectSecurity hanya boleh dipanggil pada Tingkat IRQL = PASSIVE_LEVEL dengan APC diaktifkan, jika tidak, kebuntuan atau crash dapat terjadi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), IrqlApcLte(wdm)

Lihat juga

ObReferenceObjectByHandle

ObReleaseObjectSecurity

SECURITY_DESCRIPTOR