Share via

ISecurityInformation4::GetSecondarySecurity method (aclui.h)

  • Artikel

Metode GetSecondarySecurity mengembalikan konteks keamanan tambahan yang dapat memengaruhi akses ke sumber daya.

Sintaks

HRESULT GetSecondarySecurity(
  [out] PSECURITY_OBJECT *pSecurityObjects,
  [out] PULONG           pSecurityObjectCount
);

Parameter

[out] pSecurityObjects

Array struktur SECURITY_OBJECT yang berisi objek keamanan sekunder yang terkait dengan sumber daya yang diatur pada keberhasilan. Array dimiliki oleh pemanggil dan dikosongkan dengan menggunakan fungsi LocalFree . Anggota pwszName juga dikosongkan dengan menggunakan LocalFree. Jika anggota cbData atau cbData2 dari struktur SECURITY_OBJECT bukan nol, pemanggil harus membebaskan pData atau pData2 yang sesuai dengan menggunakan LocalFree. Jika salah satu anggota tersebut nol, maka anggota pData dan pData2 yang sesuai dimiliki oleh manajer sumber daya dan harus tetap valid sampai fungsi EditKeamanan kembali

[out] pSecurityObjectCount

Jumlah objek keamanan dalam parameter pSecurityObjects yang diatur pada keberhasilan.

Menampilkan nilai

Jika metode berhasil, metode akan mengembalikan S_OK.

Jika metode gagal, metode mengembalikan kode kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Keterangan

Manajer sumber daya tidak perlu mengembalikan objek sekunder dengan anggota fWellKnown diatur ke TRUE dan anggota Id diatur ke SECURITY_OBJECT_ID_OBJECT_SD, SECURITY_OBJECT_ID_CENTRAL_POLICY, atau SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE. Objek keamanan dengan ID ini akan disediakan oleh editor kontrol akses saat memanggil ComputeEffectivePermissionWithSecondarySecurity.

Interpretasi objek keamanan yang dikembalikan terkait dengan implementasi ComputeEffectivePermissionWithSecondarySecurity.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header aclui.h

Lihat juga

ISecurityInformation4