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 멤버는 다음 값 중 하나여야 합니다(추가 정보는 설명 참조).
| 값 | 의미 |
|---|---|
|
Values 멤버는 LONG64 값의 배열을 참조합니다. |
|
Values 멤버는 ULONG64 값의 배열을 참조합니다. |
|
Values 멤버는 유니코드 문자열 값에 대한 포인터 배열을 나타냅니다. |
|
Values 멤버는 CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE 값의 배열을 참조합니다. |
|
Values 멤버는 각 CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUEpValue 멤버가 PSID인 CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE 값 배열을 참조합니다. |
|
Values 멤버는 각 요소가 부울 값을 나타내는 ULONG64 값의 배열을 참조합니다. 값 1은 TRUE 를 나타내고 값 0은 FALSE를 나타냅니다. |
|
Values 멤버는 CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE 값의 배열을 참조합니다. |
Reserved
이 멤버는 예약되어 있으며 전송될 때 0으로 설정해야 하며 수신 시 무시해야 합니다.
Flags
32비트 마스크인 특성 플래그입니다. 비트 16~31은 모든 값으로 설정할 수 있습니다. 비트 0~15는 0이거나 다음 마스크 값 중 하나 이상의 조합이어야 합니다.
| 값 | 의미 |
|---|---|
|
이 특성은 운영 체제에서 무시됩니다. 이 클레임 보안 특성은 프로세스 간에 상속되지 않습니다. |
|
클레임 보안 특성의 값은 대/소문자를 구분합니다. 이 플래그는 문자열 형식을 포함하는 값에 유효합니다. |
|
클레임 보안 특성은 ACE( 액세스 제어 항목 ) 거부에 대해서만 고려됩니다. |
|
클레임 보안 특성은 기본적으로 사용하지 않도록 설정됩니다. |
|
클레임 보안 특성이 비활성화되어 AccessCheck 함수에서 적용되지 않습니다. |
|
클레임 보안 특성은 필수입니다. |
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 |