CryptEnumOIDInfo

  • Article

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

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

Parameters

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

    Currently defined OID group IDs are:

    None

    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

  • dwFlags
    [in] Reserved for future use and must be zero.

  • pvArg
    [in] Pointer to arguments to be passed through to the callback function.

  • pfnEnumOIDInfo
    [in] Pointer to the callback function that is executed for each OID information entry enumerated.

Return Values

The function returns FALSE when the function has stopped the enumeration.

Remarks

The following is the signature for the pfnEnumOIDInfo parameter. The callback function is typically used to print out the contents of each OID entry enumerated.

BOOL (WINAPI *PFN_CRYPT_ENUM_OID_INFO)(
PCCRYPT_OID_INFO pInfo,
void *pvArg);

Parameters

  • pInfo
    [in] Pointer to the OID information.
  • pvArg
    [in] Pointer to arguments passed through to the callback function.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 3.0 or later Wincrypt.h   Crypt32.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CRYPT_OID_INFO

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.