Edit

CLAIM_SECURITY_ATTRIBUTE_RELATIVE_V1 structure (winnt.h)

  • Article

The CLAIM_SECURITY_ATTRIBUTE_RELATIVE_V1 structure defines a resource attribute that is defined in continuous memory for persistence within a serialized security descriptor.

Syntax

typedef struct _CLAIM_SECURITY_ATTRIBUTE_RELATIVE_V1 {
  DWORD Name;
  WORD  ValueType;
  WORD  Reserved;
  DWORD Flags;
  DWORD ValueCount;
  union {
    DWORD pInt64[ANYSIZE_ARRAY];
    DWORD pUint64[ANYSIZE_ARRAY];
    DWORD ppString[ANYSIZE_ARRAY];
    DWORD pFqbn[ANYSIZE_ARRAY];
    DWORD pOctetString[ANYSIZE_ARRAY];
  } Values;
} CLAIM_SECURITY_ATTRIBUTE_RELATIVE_V1, *PCLAIM_SECURITY_ATTRIBUTE_RELATIVE_V1;

Members

Name

A value that indicates an offset from the beginning of the CLAIM_SECURITY_ATTRIBUTE_RELATIVE_V1 structure to a string of Unicode characters that contain the name of the claim security attribute. The string must be at least 4 bytes in length.

ValueType

A union tag value that indicates the type of information being referred to by the Values member. The Values member will contain an array of offsets from the beginning of the CLAIM_SECURITY_ATTRIBUTE_RELATIVE_V1 structure to each value. The ValueType member must be one of the following values.

Value Meaning
CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64
0x0001
 The Values member refers to an array of offsets to LONG64 values.
CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64
0x0002
 The Values member refers to an array of offsets to ULONG64 values.
CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING
0x0003
 The Values member refers to an array of offsets to Unicode character string values.
CLAIM_SECURITY_ATTRIBUTE_TYPE_OCTET_STRING
0x0010
 The Values member refers to an array of CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE values.

Reserved

This member is currently reserved and must be set to zero when sent and must be ignored when received.

Flags

The claim security attribute flags must be zero or a combination of one or more of the following values.

Value Meaning
CLAIM_SECURITY_ATTRIBUTE_NON_INHERITABLE
0x0001
 This claim security attribute is not inherited across processes.
CLAIM_SECURITY_ATTRIBUTE_VALUE_CASE_SENSITIVE
0x0002
 The value of the claim security attribute is case sensitive. This flag is valid for values that contain string types.
CLAIM_SECURITY_ATTRIBUTE_USE_FOR_DENY_ONLY
0x0004
 The claim security attribute is considered only for deny access control entries (ACEs).
CLAIM_SECURITY_ATTRIBUTE_DISABLED_BY_DEFAULT
0x0008
 The claim security attribute is disabled by default.
CLAIM_SECURITY_ATTRIBUTE_DISABLED
0x0010
 The claim security attribute is disabled.
CLAIM_SECURITY_ATTRIBUTE_MANDATORY
0x0020
 The claim security attribute is mandatory.

ValueCount

The number of values contained in the Values member.

Values

An array of offsets from the beginning of the CLAIM_SECURITY_ATTRIBUTE_RELATIVE_V1 structure. Each offset indicates the location of a claim security attribute value of the type specified in the ValueType member.

Values.pInt64[ANYSIZE_ARRAY]

Pointer to an array of ValueCount members that is an offset from the beginning of the structure to a LONG64 of type CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64.

Values.pUint64[ANYSIZE_ARRAY]

Pointer to an array of ValueCount members where each member is an offset from the beginning of the structure to a ULONG64 of type CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64.

Values.ppString[ANYSIZE_ARRAY]

Pointer to an array of ValueCount members where each member is an offset from the beginning of the structure to a PWSTR of type CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING.

Values.pFqbn[ANYSIZE_ARRAY]

Pointer to an array of ValueCount members where each member is an offset from the beginning of the structure to the fully qualified binary name value of type CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE.

Values.pOctetString[ANYSIZE_ARRAY]

Pointer to an array of ValueCount members where each member is an offset from the beginning of the structure to a LONG64 octet string of type CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Header winnt.h