CertSetEnhancedKeyUsage

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function sets the extended key usage (EKU) property for the certificate. Use of this function replaces any EKUs associated with the certificate. To add a single EKU usage without changing existing usages, use the CertAddEnhancedKeyUsageIdentifier function. To delete as single EKU usage, use CertRemoveEnhancedKeyUsageIdentifier function.

Syntax

BOOL WINAPI CertSetEnhancedKeyUsage(
  PCCERT_CONTEXT pCertContext,
  PCERT_ENHKEY_USAGE pUsage
);

Parameters

• pCertContext
  [in] Pointer to the CERT_CONTEXT structure of the specified certificate.

• pUsage
  [in] Pointer to a CERT_ENHKEY_USAGE structure that contains an array of enhanced key usage OIDs to be set as extended properties of the certificate.

Return Value

If the function succeeds, the return value is nonzero, or TRUE.

If the function fails, the return value is zero, or FALSE.

For extended error information, call the GetLastError function.

Requirements

See Also

Reference

CertAddEnhancedKeyUsageIdentifier
CertGetEnhancedKeyUsage
CertRemoveEnhancedKeyUsageIdentifier
CERT_CONTEXT
CTL_USAGE