struttura CLAIM_SECURITY_ATTRIBUTE_V1 (winnt.h)

Articolo
08/27/2023

La struttura CLAIM_SECURITY_ATTRIBUTE_V1 definisce un attributo di sicurezza che può essere associato a un token o a un contesto di autorizzazione.

Sintassi

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;

Members

Name

Puntatore a una stringa di caratteri Unicode che contiene il nome dell'attributo di sicurezza. Questa stringa deve avere una lunghezza di almeno 4 byte.

ValueType

Valore del tag di unione che indica il tipo di informazioni contenute nel membro Values . Il membro ValueType deve essere uno dei valori seguenti (vedere le note per ulteriori informazioni).

Valore	Significato
CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64 0x0001	Il membro Values fa riferimento a una matrice di valori LONG64 .
CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64 0x0002	Il membro Values fa riferimento a una matrice di valori ULONG64 .
CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING 0x0003	Il membro Values fa riferimento a una matrice di puntatori ai valori stringa Unicode.
CLAIM_SECURITY_ATTRIBUTE_TYPE_FQBN 0x0004	Il membro Values fa riferimento a una matrice di valori CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE .
CLAIM_SECURITY_ATTRIBUTE_TYPE_SID 0x0005	Il membro Values fa riferimento a una matrice di valori CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE in cui il membro pValue di ogni CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE è un PSID.
CLAIM_SECURITY_ATTRIBUTE_TYPE_BOOLEAN 0x0006	Il membro Values fa riferimento a una matrice di valori ULONG64 in cui ogni elemento indica un valore booleano. Il valore 1 indica TRUE e il valore 0 indica FALSE.
CLAIM_SECURITY_ATTRIBUTE_TYPE_OCTET_STRING 0x0010	Il membro Values fa riferimento a una matrice di valori CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE .

Reserved

Questo membro è riservato e deve essere impostato su zero quando inviato e deve essere ignorato al momento della ricezione.

Flags

Flag di attributo che sono una maschera a 32 bit. I bit da 16 a 31 possono essere impostati su qualsiasi valore. I bit da 0 a 15 devono essere zero o una combinazione di uno o più dei valori della maschera seguenti.

Valore	Significato
CLAIM_SECURITY_ATTRIBUTE_NON_INHERITABLE 0x0001	Questo attributo viene ignorato dal sistema operativo. Questo attributo di sicurezza dell'attestazione non viene ereditato tra i processi.
CLAIM_SECURITY_ATTRIBUTE_VALUE_CASE_SENSITIVE 0x0002	Il valore dell'attributo di sicurezza attestazione fa distinzione tra maiuscole e minuscole. Questo flag è valido per i valori che contengono tipi stringa.
CLAIM_SECURITY_ATTRIBUTE_USE_FOR_DENY_ONLY 0x0004	L'attributo di sicurezza dell'attestazione viene considerato solo per le voci di controllo di accesso negate.
CLAIM_SECURITY_ATTRIBUTE_DISABLED_BY_DEFAULT 0x0008	L'attributo di sicurezza dell'attestazione è disabilitato per impostazione predefinita.
CLAIM_SECURITY_ATTRIBUTE_DISABLED 0x0010	L'attributo di sicurezza dell'attestazione è disabilitato e non verrà applicato dalla funzione AccessCheck .
CLAIM_SECURITY_ATTRIBUTE_MANDATORY 0x0020	L'attributo di sicurezza dell'attestazione è obbligatorio.

ValueCount

Numero di valori specificati nel membro Values .

Values

Matrice di valori dell'attributo di sicurezza del tipo specificato nel membro ValueType .

Values.pInt64

Puntatore a una matrice di membri ValueCount in cui ogni membro è di tipo LONG64 CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64.

Values.pUint64

Puntatore a una matrice di membri ValueCount in cui ogni membro è un ULONG64 di tipo CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64.

Values.ppString

Puntatore a una matrice di membri ValueCount in cui ogni membro è un pwstr di tipo CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING.

Values.pFqbn

Puntatore a una matrice di membri ValueCount in cui ogni membro è un valore di nome binario completo di tipo CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE.

Values.pOctetString

Puntatore a una matrice di membri ValueCount in cui ogni membro è una stringa ottetto di tipo CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE.

Commenti

Il tipo di valore del campo indica che il valore può essere una stringa ottetto o un SID. Tuttavia, la documentazione di Servizi directory per le voci di attestazioni specifica che i tipi di dati effettivi per le attestazioni sono limitati a Int64, UInt64, UnicodeString e Boolean.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Intestazione	winnt.h

Vedi anche

CLAIM_SECURITY_ATTRIBUTES_INFORMATION

Condividi tramite