Edit

IEnroll4::GetKeyLenEx method (xenroll.h)

  • Article

[This method is no longer available for use as of Windows Server 2008 and Windows Vista.]

The GetKeyLenEx method retrieves size information for the signature and exchange keys. This method was first defined in the IEnroll4 interface.

The values retrieved by this method are dependent upon the current cryptographic service provider.

Syntax

HRESULT GetKeyLenEx(
  [in]  LONG lSizeSpec,
  [in]  LONG lKeySpec,
  [out] LONG *pdwKeySize
);

Parameters

[in] lSizeSpec

Value indicating the type of size information to be retrieved. Specify one of the following values.

Value Meaning
XEKL_KEYSIZE_MIN
 Minimum key size.
XEKL_KEYSIZE_MAX
 Maximum key size.
XEKL_KEYSIZE_INC
 Size of key increment. For more information, see Remarks.

[in] lKeySpec

Specifies the key for which size information is returned. Specify one of the following values.

Value Meaning
XEKL_KEYSPEC_KEYX
 Exchange key
XEKL_KEYSPEC_SIG
 Signature key

[out] pdwKeySize

A pointer to LONG that receives the key size information, in bits.

Return value

None

Remarks

If the cryptographic service provider does not support this method, an error is returned.

For additional details on the XEKL_KEYSIZE_INC value, see PP_SIG_KEYSIZE_INC usage in the CryptGetProvParam reference page.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header xenroll.h
Library Uuid.lib
DLL Xenroll.dll

See also

IEnroll4