ObjectIdGroupId enumeration (certenroll.h)
The ObjectIdGroupId enumeration type specifies the category or group to which an object identifier (OID) belongs. This enumeration is used when calling InitializeFromAlgorithmName to initialize an IObjectId object.
Syntax
typedef enum ObjectIdGroupId {
XCN_CRYPT_ANY_GROUP_ID = 0,
XCN_CRYPT_HASH_ALG_OID_GROUP_ID = 1,
XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID = 2,
XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID = 3,
XCN_CRYPT_SIGN_ALG_OID_GROUP_ID = 4,
XCN_CRYPT_RDN_ATTR_OID_GROUP_ID = 5,
XCN_CRYPT_EXT_OR_ATTR_OID_GROUP_ID = 6,
XCN_CRYPT_ENHKEY_USAGE_OID_GROUP_ID = 7,
XCN_CRYPT_POLICY_OID_GROUP_ID = 8,
XCN_CRYPT_TEMPLATE_OID_GROUP_ID = 9,
XCN_CRYPT_KDF_OID_GROUP_ID = 10,
XCN_CRYPT_LAST_OID_GROUP_ID = 10,
XCN_CRYPT_FIRST_ALG_OID_GROUP_ID = 1,
XCN_CRYPT_LAST_ALG_OID_GROUP_ID = 4,
XCN_CRYPT_GROUP_ID_MASK = 0xffff,
XCN_CRYPT_OID_PREFER_CNG_ALGID_FLAG = 0x40000000,
XCN_CRYPT_OID_DISABLE_SEARCH_DS_FLAG = 0x80000000,
XCN_CRYPT_OID_INFO_OID_GROUP_BIT_LEN_MASK = 0xfff0000,
XCN_CRYPT_OID_INFO_OID_GROUP_BIT_LEN_SHIFT = 16,
XCN_CRYPT_KEY_LENGTH_MASK = 0xfff0000
} ;
Constants
XCN_CRYPT_ANY_GROUP_ID Value: 0 The group OID is not identified. All OID groups will be included when searching. |
XCN_CRYPT_HASH_ALG_OID_GROUP_ID Value: 1 Hashing algorithm group. This includes the following OIDs:
|
XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID Value: 2 Symmetric encryption algorithm group. This includes the following OIDs:
|
XCN_CRYPT_PUBKEY_ALG_OID_GROUP_ID Value: 3 Asymmetric encryption algorithm group. This includes the following OIDs:
|
XCN_CRYPT_SIGN_ALG_OID_GROUP_ID Value: 4 Signing algorithm group. This includes the following OIDs:
|
XCN_CRYPT_RDN_ATTR_OID_GROUP_ID Value: 5 Relative distinguished name (RDN) group. This includes the following OIDs:
|
XCN_CRYPT_EXT_OR_ATTR_OID_GROUP_ID Value: 6 Extension and attribute group. This includes the following OIDs:
|
XCN_CRYPT_ENHKEY_USAGE_OID_GROUP_ID Value: 7 Enhanced key usage (EKU) extension group. This includes the following OIDs:
|
XCN_CRYPT_POLICY_OID_GROUP_ID Value: 8 Issuance policy group. This includes the following OIDs. The x.y.z portion of each OID represents a randomly generated numeric sequence that is unique for each forest.
|
XCN_CRYPT_TEMPLATE_OID_GROUP_ID Value: 9 Certificate template group. The OIDs in this group identify the certificate templates that are available to the client, and all begin with 1.3.6.1.4.1.311.21.8. but are completed by randomly generated numeric sequences that are unique for each forest. |
XCN_CRYPT_KDF_OID_GROUP_ID Value: 10 |
XCN_CRYPT_LAST_OID_GROUP_ID Value: 10 Equivalent to XCN_CRYPT_TEMPLATE_OID_GROUP_ID. You can use this value to iterate through the group OIDs. |
XCN_CRYPT_FIRST_ALG_OID_GROUP_ID Value: 1 Equivalent to XCN_CRYPT_HASH_ALG_OID_GROUP_ID. You can use this value to iterate through the group algorithm OIDs. |
XCN_CRYPT_LAST_ALG_OID_GROUP_ID Value: 4 Equivalent to XCN_CRYPT_SIGN_ALG_OID_GROUP_ID. You can use this value to iterate through the group algorithm OIDs. |
XCN_CRYPT_GROUP_ID_MASK Value: 0xffff |
XCN_CRYPT_OID_PREFER_CNG_ALGID_FLAG Value: 0x40000000 |
XCN_CRYPT_OID_DISABLE_SEARCH_DS_FLAG Value: 0x80000000 Not supported. |
XCN_CRYPT_OID_INFO_OID_GROUP_BIT_LEN_MASK Value: 0xfff0000 |
XCN_CRYPT_OID_INFO_OID_GROUP_BIT_LEN_SHIFT Value: 16 |
XCN_CRYPT_KEY_LENGTH_MASK Value: 0xfff0000 Enables addition of a key length to the upper 16 bits of the XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID group ID. For example, to use the InitializeFromAlgorithmName method to initialize an IObjectId object from a 192-bit AES algorithm, specify "AES" for the strAlgorithmName parameter, shift the length left by 16, and perform a bitwise-OR combination on the shifted bit length and the GroupId value. syntax<br>DWORD dwBitLen = 192;<br><br>ObjectIdGroupId GroupId = <br> (ObjectIdGroupId) (XCN_CRYPT_ENCRYPT_ALG_OID_GROUP_ID | <br> (XCN_CRYPT_KEY_LENGTH_MASK & (dwBitLen << 16)));<br><br> |
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2008 [desktop apps only] |
Header | certenroll.h |