CLAIM_SECURITY_ATTRIBUTE_V1-Struktur (winnt.h)

Artikel
03/04/2024

Die CLAIM_SECURITY_ATTRIBUTE_V1-Struktur definiert ein Sicherheitsattribute, das einem Token oder Autorisierungskontext zugeordnet werden kann.

Syntax

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;

Member

Name

Ein Zeiger auf eine Zeichenfolge von Unicode-Zeichen, die den Namen des Sicherheitsattributes enthält. Diese Zeichenfolge muss mindestens 4 Byte lang sein.

ValueType

Ein Union-Tagwert, der den Typ der informationen angibt, die im Values-Element enthalten sind. Der ValueType-Member muss einer der folgenden Werte sein (weitere Informationen finden Sie in den Hinweisen).

Wert	Bedeutung
CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64 0x0001	Der Values-Member bezieht sich auf ein Array von LONG64-Werten .
CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64 0x0002	Der Values-Member bezieht sich auf ein Array von ULONG64 Werten.
CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING 0x0003	Das Values-Element bezieht sich auf ein Array von Zeigern auf Unicode-Zeichenfolgenwerte.
CLAIM_SECURITY_ATTRIBUTE_TYPE_FQBN 0x0004	Das Values-Element bezieht sich auf ein Array von CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE Werten.
CLAIM_SECURITY_ATTRIBUTE_TYPE_SID 0x0005	Das Values-Element bezieht sich auf ein Array von CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE Werten, wobei der pValue-Member jedes CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE eine PSID ist.
CLAIM_SECURITY_ATTRIBUTE_TYPE_BOOLEAN 0x0006	Der Values-Member bezieht sich auf ein Array von ULONG64 Werten, wobei jedes Element einen booleschen Wert angibt. Der Wert 1 gibt TRUE an, und der Wert 0 gibt FALSE an.
CLAIM_SECURITY_ATTRIBUTE_TYPE_OCTET_STRING 0x0010	Das Values-Element bezieht sich auf ein Array von CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE Werten.

Reserved

Dieser Member ist reserviert und muss beim Senden auf 0 (null) festgelegt werden und beim Empfang ignoriert werden.

Flags

Die Attributflags, die eine 32-Bit-Maske sind. Die Bits 16 bis 31 können auf einen beliebigen Wert festgelegt werden. Die Bits 0 bis 15 müssen null oder eine Kombination aus einem oder mehreren der folgenden Maskenwerte sein.

Wert	Bedeutung
CLAIM_SECURITY_ATTRIBUTE_NON_INHERITABLE 0x0001	Dieses Attribut wird vom Betriebssystem ignoriert. Dieses Anspruchssicherheitsattribut wird nicht prozessübergreifend geerbt.
CLAIM_SECURITY_ATTRIBUTE_VALUE_CASE_SENSITIVE 0x0002	Beim Wert des Anspruchssicherheitsattributs wird die Groß-/Kleinschreibung beachtet. Dieses Flag ist für Werte gültig, die Zeichenfolgentypen enthalten.
CLAIM_SECURITY_ATTRIBUTE_USE_FOR_DENY_ONLY 0x0004	Das Anspruchssicherheitsattribut wird nur für Zugriffssteuerungseinträge (Access Control Entries , ACEs) deny berücksichtigt.
CLAIM_SECURITY_ATTRIBUTE_DISABLED_BY_DEFAULT 0x0008	Das Anspruchssicherheitsattribut ist standardmäßig deaktiviert.
CLAIM_SECURITY_ATTRIBUTE_DISABLED 0x0010	Das Anspruchssicherheitsattribut ist deaktiviert und wird nicht von der AccessCheck-Funktion angewendet.
CLAIM_SECURITY_ATTRIBUTE_MANDATORY 0x0020	Das Anspruchssicherheitsattribut ist obligatorisch.

ValueCount

Die Anzahl von Werten, die im Values-Element angegeben sind.

Values

Ein Array von Sicherheitsattributewerten des im ValueType-Member angegebenen Typs.

Values.pInt64

Zeiger auf ein Array von ValueCount-Membern , wobei jedes Element ein LONG64 vom Typ CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64 ist.

Values.pUint64

Zeiger auf ein Array von ValueCount-Membern , wobei jedes Element eine ULONG64 vom Typ CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64 ist.

Values.ppString

Zeiger auf ein Array von ValueCount-Membern , wobei jedes Element ein PWSTR vom Typ CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING ist.

Values.pFqbn

Zeiger auf ein Array von ValueCount-Membern , wobei jedes Element ein vollqualifizierter binärer Namenswert vom Typ CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE ist.

Values.pOctetString

Zeiger auf ein Array von ValueCount-Membern , wobei jedes Element eine Oktettzeichenfolge vom Typ CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE ist.

Hinweise

Der Feldwerttyp gibt an, dass der Wert eine Oktettzeichenfolge oder eine SID sein kann. Die Verzeichnisdienste-Dokumentation für Anspruchseinträge gibt jedoch an, dass effektive mögliche Datentypen für Ansprüche auf Int64, UInt64, UnicodeString und Boolean beschränkt sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	winnt.h

Weitere Informationen

CLAIM_SECURITY_ATTRIBUTES_INFORMATION

Share via