CryptFindOIDInfo

  • Article

This function retrieves the first predefined or registered CRYPT_OID_INFO structure matching a specified key type and key. The search can be limited to object identifiers (OID) within a specified OID group.

Use the CryptEnumOIDInfo function to list all or selected subsets of CRYPT_OID_INFO structures.

New OIDs can be placed in the list of registered OIDs either before or after the predefined entries. Because the CryptFindOIDInfo function returns the first key on the list that matches the search criteria, a newly registered OID placed before a predefined OID entry with the same key overrides a predefined entry.

PCCRYPT_OID_INFO WINAPI CryptFindOIDInfo(
DWORD dwKeyType,
void *pvKey,
DWORD dwGroupId
);

Parameters

  • dwKeyType
    [in] Specifies the key type to use when finding OID information.

    Currently defined key types are shown in the following table.

    Key type Type of pvKey
    CRYPT_OID_INFO_OID_KEY The pvKey parameter points to a szOID.
    CRYPT_OID_INFO_NAME_KEY The pvKey parameter points to a pwszName.
    CRYPT_OID_INFO_ALGID_KEY The pvKey parameter points to an ALG_ID.
    CRYPT_OID_INFO_SIGN_KEY The pvKey parameter points to an array of two ALG_IDs where:

    ALG_ID[0] is the Hash AlgId.

    ALG_ID[1] is the PubKey AlgId.

  • pvKey
    [in] Depends on the dwKeyType parameter. See the table under dwkeytype for details.

  • dwGroupId
    [in] Specifies the group identifier to use when finding OID information. Setting dwGroupId to zero searches all groups according to the dwKeyType. Otherwise, only the dwGroupId indicated is searched.

    See CryptEnumOIDInfo for code that lists the OID information by group ID.

Return Values

Returns a pointer to a constant structure of the CRYPT_OID_INFO type. The returned pointer must not be freed. NULL is returned when the specified key and group is not found.

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

CryptEnumOIDInfo, ALG_ID, CRYPT_ALGORITHM_IDENTIFIER, CRYPT_OID_INFO

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.