Share via

CLAIM_SECURITY_ATTRIBUTE_V1 구조체(winnt.h)

  • 아티클

CLAIM_SECURITY_ATTRIBUTE_V1 구조는 토큰 또는 권한 부여 컨텍스트와 연결할 수 있는 보안 특성을 정의합니다.

구문

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;

멤버

Name

보안 특성의 이름을 포함하는 유니코드 문자 문자열에 대한 포인터입니다. 이 문자열의 길이는 4바이트 이상이어야 합니다.

ValueType

Values 멤버에 포함된 정보의 형식을 나타내는 공용 구조체 태그 값입니다. ValueType 멤버는 다음 값 중 하나여야 합니다(추가 정보는 설명 참조).

값 의미
CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64
0x0001
 Values 멤버는 LONG64 값의 배열을 참조합니다.
CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64
0x0002
 Values 멤버는 ULONG64 값의 배열을 참조합니다.
CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING
0x0003
 Values 멤버는 유니코드 문자열 값에 대한 포인터 배열을 나타냅니다.
CLAIM_SECURITY_ATTRIBUTE_TYPE_FQBN
0x0004
 Values 멤버는 CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE 값의 배열을 참조합니다.
CLAIM_SECURITY_ATTRIBUTE_TYPE_SID
0x0005
 Values 멤버는 각 CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUEpValue 멤버가 PSID인 CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE 값 배열을 참조합니다.
CLAIM_SECURITY_ATTRIBUTE_TYPE_BOOLEAN
0x0006
 Values 멤버는 각 요소가 부울 값을 나타내는 ULONG64 값의 배열을 참조합니다. 값 1은 TRUE 를 나타내고 값 0은 FALSE를 나타냅니다.
CLAIM_SECURITY_ATTRIBUTE_TYPE_OCTET_STRING
0x0010
 Values 멤버는 CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE 값의 배열을 참조합니다.

Reserved

이 멤버는 예약되어 있으며 전송될 때 0으로 설정해야 하며 수신 시 무시해야 합니다.

Flags

32비트 마스크인 특성 플래그입니다. 비트 16~31은 모든 값으로 설정할 수 있습니다. 비트 0~15는 0이거나 다음 마스크 값 중 하나 이상의 조합이어야 합니다.

값 의미
CLAIM_SECURITY_ATTRIBUTE_NON_INHERITABLE
0x0001
 이 특성은 운영 체제에서 무시됩니다. 이 클레임 보안 특성은 프로세스 간에 상속되지 않습니다.
CLAIM_SECURITY_ATTRIBUTE_VALUE_CASE_SENSITIVE
0x0002
 클레임 보안 특성의 값은 대/소문자를 구분합니다. 이 플래그는 문자열 형식을 포함하는 값에 유효합니다.
CLAIM_SECURITY_ATTRIBUTE_USE_FOR_DENY_ONLY
0x0004
 클레임 보안 특성은 ACE( 액세스 제어 항목 ) 거부에 대해서만 고려됩니다.
CLAIM_SECURITY_ATTRIBUTE_DISABLED_BY_DEFAULT
0x0008
 클레임 보안 특성은 기본적으로 사용하지 않도록 설정됩니다.
CLAIM_SECURITY_ATTRIBUTE_DISABLED
0x0010
 클레임 보안 특성이 비활성화되어 AccessCheck 함수에서 적용되지 않습니다.
CLAIM_SECURITY_ATTRIBUTE_MANDATORY
0x0020
 클레임 보안 특성은 필수입니다.

ValueCount

Values 멤버에 지정된 값의 수입니다.

Values

ValueType 멤버에 지정된 형식의 보안 특성 값 배열입니다.

Values.pInt64

각 멤버가 CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64 형식의 LONG64인 ValueCount 멤버 배열에 대한 포인터입니다.

Values.pUint64

각 멤버가 CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64 형식의 ULONG64ValueCount 멤버 배열에 대한 포인터입니다.

Values.ppString

각 멤버가 CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING 형식의 PWSTR인 ValueCount 멤버 배열에 대한 포인터입니다.

Values.pFqbn

각 멤버가 CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE 형식의 정규화된 이진 이름 값인 ValueCount 멤버 배열에 대한 포인터입니다.

Values.pOctetString

각 멤버가 CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE 형식의 8진수 문자열인 ValueCount 멤버의 배열에 대한 포인터입니다.

설명

필드 값 형식은 값이 옥릿 문자열 또는 SID일 수 있음을 나타냅니다. 그러나 클레임 항목에 대한 Directory Services 설명서 에서는 클레임에 대해 유효한 가능한 데이터 형식이 Int64, UInt64, UnicodeString 및 Boolean으로 제한되도록 지정합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
머리글 winnt.h

추가 정보

CLAIM_SECURITY_ATTRIBUTES_INFORMATION