IX509Extension::Critical property

The Critical property specifies and retrieves a Boolean value that identifies whether the certificate extension is critical. This property is web enabled on input.

This property is read/write.

Syntax


HRESULT put_Critical(
  [in]   VARIANT_BOOL Value
);

HRESULT get_Critical(
  [out]  VARIANT_BOOL *pValue
);

Property value

A VARIANT_BOOL variable that identifies extension criticality. Specify VARIANT_TRUE to indicate that the extension is critical.

Error codes

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

A certificate extension consists of an object identifier (OID), a Boolean value that identifies whether the extension is critical, and a byte array that contains the extension value. The criticality indicates whether an application that uses a certificate can ignore the extension type and value. If an extension is identified as critical but the application does not recognize the extension type, the application should reject the certificate.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

CertEnroll.h

DLL

CertEnroll.dll

See also

IX509Extension

 

 

Community Additions

ADD
Show:
© 2014 Microsoft