共用方式為

winnt.h (CLAIM_SECURITY_ATTRIBUTE_V1 結構)

  • 發行項

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

Unicode 字元字串的指標，其中包含安全性屬性的名稱。 此字串長度必須至少為 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 成員是指 Unicode 字串值的指標陣列。
CLAIM_SECURITY_ATTRIBUTE_TYPE_FQBN
0x0004
 Values 成員是指CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE值的陣列。
CLAIM_SECURITY_ATTRIBUTE_TYPE_SID
0x0005
 Values 成員是指CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE值的陣列，其中每個CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE的 pValue 成員都是 PSID。
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

這個成員是保留的，而且在傳送時必須設定為零，而且在收到時必須忽略。

Flags

屬於32位掩碼的屬性旗標。 位16到31可能會設定為任何值。 位 0 到 15 必須是零或下列一或多個遮罩值的組合。

值 意義
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

ValueCount 成員陣列的指標，其中每個成員都是類型為 CLAIM_SECURITY_ATTRIBUTE_TYPE_INT64的LONG64。

Values.pUint64

ValueCount 成員陣列的指標，其中每個成員都是類型CLAIM_SECURITY_ATTRIBUTE_TYPE_UINT64 ULONG64。

Values.ppString

ValueCount 成員陣列的指標，其中每個成員都是類型為 CLAIM_SECURITY_ATTRIBUTE_TYPE_STRING的 PWSTR。

Values.pFqbn

ValueCount 成員陣列的指標，其中每個成員都是類型CLAIM_SECURITY_ATTRIBUTE_FQBN_VALUE的完整二進位名稱值。

Values.pOctetString

ValueCount 成員陣列的指標，其中每個成員都是類型為CLAIM_SECURITY_ATTRIBUTE_OCTET_STRING_VALUE的八位字串。

備註

域值類型表示此值可以是八位字串或 SID。 不過， 宣告專案的目錄服務檔 會指定宣告的有效可能數據類型限製為Int64、UInt64、UnicodeString和 Boolean。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
標頭 winnt.h

另請參閱

CLAIM_SECURITY_ATTRIBUTES_INFORMATION