Export (0) Print
Expand All
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CertGetIntendedKeyUsage

Windows CE 3.0

This function acquires the intended key usage bytes from a certificate. The intended key usage can be in either the szOID_KEY_USAGE ("2.5.29.15") or szOID_KEY_ATTRIBUTES ("2.5.29.2") extension.

BOOL WINAPI CertGetIntendedKeyUsage(
DWORD dwCertEncodingType,
PCERT_INFO pCertInfo,
BYTE *pbKeyUsage,
DWORD cbKeyUsage
);

Parameters

dwCertEncodingType
[in] Specifies the encoding type used. Currently, only X509_ASN_ENCODING is used; however, additional encoding types may be added in the future.
pCertInfo
[in] Pointer to the CERT_INFO structure of the specified certificate.
pbKeyUsage
[in] Pointer to a buffer containing the intended key usage. The following list shows the currently defined values, which can be combined using bitwise OR operations:

CERT_DATA_ENCIPHERMENT_KEY_USAGE

CERT_DIGITAL_SIGNATURE_KEY_USAGE

CERT_KEY_AGREEMENT_KEY_USAGE

CERT_KEY_CERT_SIGN_KEY_USAGE

CERT_KEY_ENCIPHERMENT_KEY_USAGE

CERT_NON_REPUDIATION_KEY_USAGE

CERT_OFFLINE_CRL_SIGN_KEY_USAGE

cbKeyUsage
[in] Size, in bytes, of the intended key usage. Currently, the intended key usage occupies only 1 byte of data.

Return Values

If the certificate does not have any intended key usage bytes, FALSE is returned and the pbKeyUsage parameter is set to zero. Otherwise, TRUE is returned and up to the cbKeyUsage number of bytes are copied into the pbKeyUsage parameter. Any remaining bytes not copied are set to zero.

For extended error information, call the GetLastError function. This function has the following error code.

Error code Description
ERROR_FILE_NOT_FOUND Invalid certificate encoding type. Currently only X509_ASN_ENCODING is supported.

Remarks

The desktop platform supports the PKCS_7_ASN_ENCODING flag, but Windows CE does not. Windows CE ignores the flag when it is specified.

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

CERT_INFO


 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.

Show:
© 2014 Microsoft