struktur CLAIM_SECURITY_ATTRIBUTE_V1 (winnt.h)

Artikel
03/08/2023

Struktur CLAIM_SECURITY_ATTRIBUTE_V1 mendefinisikan atribut keamanan yang dapat dikaitkan dengan token atau konteks otorisasi.

Sintaks

typedef struct _CLAIM_SECURITY_ATTRIBUTE_V1 {
  PWSTR Name;
  WORD  ValueType;
  WORD  Reserved;
  DWORD Flags;
  DWORD ValueCount;
  union {
    PLONG64                                      pInt64;
    PDWORD64                                     pUint64;
    PWSTR                                        *ppString;
    PCLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE         pFqbn;
    PCLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE pOctetString;
  } Values;
} CLAIM_SECURITY_ATTRIBUTE_V1, *PCLAIM_SECURITY_ATTRIBUTE_V1;

Anggota

Name

Penunjuk ke string karakter Unicode yang berisi nama atribut keamanan. Panjang string ini harus minimal 4 byte.

ValueType

Nilai tag union yang menunjukkan jenis informasi yang terkandung dalam anggota Nilai . Anggota ValueType harus menjadi salah satu nilai berikut (lihat keterangan untuk informasi tambahan).

Nilai	Makna
CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64 0x0001	Anggota Nilai mengacu pada array nilai LONG64 .
CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64 0x0002	Anggota Nilai mengacu pada array nilai ULONG64 .
CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING 0x0003	Anggota Nilai mengacu pada array pointer ke nilai string Unicode.
CLAIM_SECURITY_ATTRIBUTE_TYPE_FQBN 0x0004	Anggota Nilai mengacu pada array nilai CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE .
CLAIM_SECURITY_ATTRIBUTE_TYPE_SID 0x0005	Anggota Nilai mengacu pada array nilai CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE di mana anggota pValue dari setiap CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE adalah PSID.
CLAIM_SECURITY_ATTRIBUTE_TYPE_BOOLEAN 0x0006	Anggota Nilai mengacu pada array nilai ULONG64 di mana setiap elemen menunjukkan nilai Boolean. Nilai 1 menunjukkan TRUE dan nilai 0 menunjukkan FALSE.
CLAIM_SECURITY_ATTRIBUTE_TYPE_OCTET_STRING 0x0010	Anggota Nilai mengacu pada array nilai CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE .

Reserved

Anggota ini dicadangkan dan harus diatur ke nol saat dikirim dan harus diabaikan saat diterima.

Flags

Bendera atribut yang merupakan 32-bitmask. Bit 16 hingga 31 dapat diatur ke nilai apa pun. Bit 0 hingga 15 harus nol atau kombinasi dari satu atau beberapa nilai masker berikut.

Nilai	Makna
CLAIM_SECURITY_ATTRIBUTE_NON_INHERITABLE 0x0001	Atribut ini diabaikan oleh sistem operasi. Atribut keamanan klaim ini tidak diwariskan di seluruh proses.
CLAIM_SECURITY_ATTRIBUTE_VALUE_CASE_SENSITIVE 0x0002	Nilai atribut keamanan klaim peka huruf besar/kecil. Bendera ini valid untuk nilai yang berisi jenis string.
CLAIM_SECURITY_ATTRIBUTE_USE_FOR_DENY_ONLY 0x0004	Atribut keamanan klaim hanya dianggap untuk menolak entri kontrol akses (ACE).
CLAIM_SECURITY_ATTRIBUTE_DISABLED_BY_DEFAULT 0x0008	Atribut keamanan klaim dinonaktifkan secara default.
CLAIM_SECURITY_ATTRIBUTE_DISABLED 0x0010	Atribut keamanan klaim dinonaktifkan dan tidak akan diterapkan oleh fungsi AccessCheck .
CLAIM_SECURITY_ATTRIBUTE_MANDATORY 0x0020	Atribut keamanan klaim bersifat wajib.

ValueCount

Jumlah nilai yang ditentukan dalam anggota Nilai .

Values

Array nilai atribut keamanan dari jenis yang ditentukan dalam anggota ValueType .

Values.pInt64

Penunjuk ke array anggota ValueCount di mana setiap anggota adalah LONG64 jenis CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64.

Values.pUint64

Penunjuk ke array anggota ValueCount di mana setiap anggota adalah ULONG64 jenis CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64.

Values.ppString

Penunjuk ke array anggota ValueCount di mana setiap anggota adalah PWSTR jenis CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING.

Values.pFqbn

Penunjuk ke array anggota ValueCount di mana setiap anggota adalah nilai nama biner yang sepenuhnya memenuhi syarat dari jenis CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE.

Values.pOctetString

Penunjuk ke array anggota ValueCount di mana setiap anggota adalah string oktet jenis CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE.

Keterangan

Jenis nilai bidang menunjukkan bahwa nilainya bisa berupa string oktet atau SID. Namun, dokumentasi Layanan Direktori untuk entri klaim menentukan bahwa kemungkinan jenis data yang efektif untuk klaim terbatas pada Int64, UInt64, UnicodeString, dan Boolean.

Persyaratan

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

Lihat juga

CLAIM_SECURITY_ATTRIBUTES_INFORMATION

Bagikan melalui