CryptEnumOIDInfo function

The CryptEnumOIDInfo function enumerates predefined and registered object identifier (OID) CRYPT_OID_INFO structures. This function enumerates either all of the predefined and registered structures or only structures identified by a selected OID group. For each OID information structure enumerated, an application provided callback function, pfnEnumOIDInfo, is called.

Syntax

BOOL CryptEnumOIDInfo(
  DWORD                   dwGroupId,
  DWORD                   dwFlags,
  void                    *pvArg,
  PFN_CRYPT_ENUM_OID_INFO pfnEnumOIDInfo
);

Parameters

dwGroupId

Indicates which OID groups to be matched. Setting dwGroupId to zero matches all groups. If dwGroupId is greater than zero, only the OID entries in the specified group are enumerated.

The currently defined OID group IDs are:

  • CRYPT_HASH_ALG_OID_GROUP_ID
  • CRYPT_ENCRYPT_ALG_OID_GROUP_ID
  • CRYPT_PUBKEY_ALG_OID_GROUP_ID
  • CRYPT_SIGN_ALG_OID_GROUP_ID
  • CRYPT_RDN_ATTR_OID_GROUP_ID
  • CRYPT_EXT_OR_ATTR_OID_GROUP_ID
  • CRYPT_ENHKEY_USAGE_OID_GROUP_ID
  • CRYPT_POLICY_OID_GROUP_ID
  • CRYPT_TEMPLATE_OID_GROUP_ID
  • CRYPT_KDF_OID_GROUP_IDWindows Server 2008, Windows Vista, Windows Server 2003 and Windows XP:  The CRYPT_KDF_OID_GROUP_ID value is not supported.
  • CRYPT_LAST_OID_GROUP_ID
  • CRYPT_FIRST_ALG_OID_GROUP_ID
  • CRYPT_LAST_ALG_OID_GROUP_ID

dwFlags

This parameter is reserved for future use. It must be zero.

pvArg

A pointer to arguments to be passed through to the callback function.

pfnEnumOIDInfo

A pointer to the callback function that is executed for each OID information entry enumerated. For information about the callback parameters, see CRYPT_ENUM_OID_INFO.

Return Value

If the callback function completes the enumeration, this function returns TRUE.

If the callback function has stopped the enumeration, this function returns FALSE.

Requirements

   
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header wincrypt.h
Library Crypt32.lib
DLL Crypt32.dll

See Also

OID Support Functions