IAccCertificate Interface Reference

---

Detailed Description

The IAccCertificate interface is used to wrap X.509 certificate objects.

Public Types

• enum AccCertificateTrustFlags {
    AccCertificateTrustFlags_Ssl = 0x1,
    AccCertificateTrustFlags_Email = 0x2,
    AccCertificateTrustFlags_ObjectSigning = 0x4
  }
• enum AccCertificateUsage {
    AccCertificateUsage_SslClient = 0x01,
    AccCertificateUsage_SslServer = 0x02,
    AccCertificateUsage_Signing = 0x10,
    AccCertificateUsage_Encryption = 0x20
  }
• enum AccCertificateProp {
    AccCertificateProp_Name,
    AccCertificateProp_SerialNumber,
    AccCertificateProp_IssueTime,
    AccCertificateProp_ExpireTime,
    AccCertificateProp_Usage,
    AccCertificateProp_SubjectCommonName = 10,
    AccCertificateProp_SubjectOrg,
    AccCertificateProp_SubjectOrgUnit,
    AccCertificateProp_SubjectDomainComponent,
    AccCertificateProp_SubjectEmailAddress,
    AccCertificateProp_IssuerCommonName = 20,
    AccCertificateProp_IssuerOrg,
    AccCertificateProp_IssuerOrgUnit,
    AccCertificateProp_IssuerDomainComponent,
    AccCertificateProp_Trusted = 30
  }
• typedef enum
  IAccCertificate::AccCertificateTrustFlags AccCertificateTrustFlags
• typedef enum
  IAccCertificate::AccCertificateUsage AccCertificateUsage
• typedef enum
  IAccCertificate::AccCertificateProp AccCertificateProp

Public Member Functions

• HRESULT Property ([in] AccCertificateProp property,[out, retval] xp_variant *value)
• HRESULT GetChain ([in] xp_vbool wantRoot,[out, retval] xp_variant *certs)
• HRESULT Verify ([in] xp_int usage)
• HRESULT Trust ([in] xp_int trustFlags,[in, defaultvalue(0)] xp_vbool permanent)

---

Member Typedef Documentation

typedef enum IAccCertificate::AccCertificateTrustFlags IAccCertificate::AccCertificateTrustFlags

Categories of trust for the certificate.

typedef enum IAccCertificate::AccCertificateUsage IAccCertificate::AccCertificateUsage

Usage types for the certificate.

typedef enum IAccCertificate::AccCertificateProp IAccCertificate::AccCertificateProp

Properties for the Property method.

---

Member Enumeration Documentation

enum IAccCertificate::AccCertificateTrustFlags

Categories of trust for the certificate.

Enumerator:

AccCertificateTrustFlags_Ssl
AccCertificateTrustFlags_Email
AccCertificateTrustFlags_ObjectSigning

enum IAccCertificate::AccCertificateUsage

Usage types for the certificate.

Enumerator:

AccCertificateUsage_SslClient
AccCertificateUsage_SslServer
AccCertificateUsage_Signing
AccCertificateUsage_Encryption

enum IAccCertificate::AccCertificateProp

Properties for the Property method.

Enumerator:

AccCertificateProp_Name	The friendly name for the certificate [get] xp_str*
AccCertificateProp_SerialNumber	The serial number of the certificate [get] xp_str*
AccCertificateProp_IssueTime	The time the certificate was issued [get] xp_date*
AccCertificateProp_ExpireTime	The time the certificate expires [get] xp_date*
AccCertificateProp_Usage	The certificate usage type; values are from AccCertificateUsage. [get] xp_uint*
AccCertificateProp_SubjectCommonName	The subject name for the certificate (CN) [get] xp_str*
AccCertificateProp_SubjectOrg	The organization name for the certificate (O) [get] xp_str*
AccCertificateProp_SubjectOrgUnit	The organizational unit for the certificate (OU) [get] xp_str*
AccCertificateProp_SubjectDomainComponent	The domain component for the certificate (DC) [get] xp_str*
AccCertificateProp_SubjectEmailAddress	The email address for the certificate [get] xp_str*
AccCertificateProp_IssuerCommonName	The issuer name [get] xp_str*
AccCertificateProp_IssuerOrg	The issuer organization [get] xp_str*
AccCertificateProp_IssuerOrgUnit	The issuer organizational unit [get] xp_str*
AccCertificateProp_IssuerDomainComponent	The issuer domain component [get] xp_str*
AccCertificateProp_Trusted	The categories in which this certificate has been trusted; values are from AccCertificateTrustFlags [get] xp_uint*

---

Member Function Documentation

HRESULT IAccCertificate::Property	(	[in] AccCertificateProp	property,
		[out, retval] xp_variant *	value
	)			[get]

Get a specific property of the certificate.

HRESULT IAccCertificate::GetChain	(	[in] xp_vbool	wantRoot,
		[out, retval] xp_variant *	certs
	)

Get this cert's cert chain, optionally including the root cert, as a list of IAccCertificates.

HRESULT IAccCertificate::Verify

(

[in] xp_int

usage

)

Verifies that the certificate is valid at the current time, for the specified usages.

HRESULT IAccCertificate::Trust	(	[in] xp_int	trustFlags,
		[in, defaultvalue(0)] xp_vbool	permanent
	)

Explicitly trust this cert for the specified categories, either for the current session or permanently.