PFN_CRYPT_ENUM_KEYID_PROP callback function (wincrypt.h)

The CRYPT_ENUM_KEYID_PROP callback function is used with the CryptEnumKeyIdentifierProperties function.

Syntax

PFN_CRYPT_ENUM_KEYID_PROP PfnCryptEnumKeyidProp;

BOOL PfnCryptEnumKeyidProp(
  [in]      const CRYPT_HASH_BLOB *pKeyIdentifier,
  [in]      DWORD dwFlags,
  [in]      void *pvReserved,
  [in, out] void *pvArg,
  [in]      DWORD cProp,
  [in]      DWORD *rgdwPropId,
  [in]      void **rgpvData,
  [in]      DWORD *rgcbData
)
{...}

Parameters

[in] pKeyIdentifier

A pointer to a CRYPT_INTEGER_BLOB that contains the key identifier.

[in] dwFlags

Reserved for future use and must be zero.

[in] pvReserved

Reserved for future use. Must be NULL.

[in, out] pvArg

A pointer to an argument that is passed back from the callback function.

[in] cProp

Count of elements in the array of rgdwPropId

[in] rgdwPropId

A pointer to an array of property identifiers. Each entry in the array will be one of the value types listed for in the table for dwPropId in the CryptSetKeyIdentifierProperty function.

[in] rgpvData

A pointer to an array that contains pointers to pvData elements corresponding the rgdwPropId array elements.

For CERT_KEY_PROV_INFO_PROP_ID the rgpvData element points to a CRYPT_KEY_PROV_INFO structure. For all other properties, the rgpvData element points to an array of bytes.

[in] rgcbData

Array of DWORDs that specify the size, in bytes, of corresponding elements in the rgpvData array.

Return value

Returns TRUE if the function succeeds, FALSE if it fails.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header wincrypt.h

See also

CRYPT_INTEGER_BLOB

CRYPT_KEY_PROV_INFO

CryptEnumKeyIdentifierProperties

CryptSetKeyIdentifierProperty