IX509AttributeExtensions::InitializeEncode method (certenroll.h)

The InitializeEncode method initializes the object from an IX509Extensions collection.

Syntax

HRESULT InitializeEncode(
  [in] IX509Extensions *pExtensions
);

Parameters

[in] pExtensions

Pointer to an IX509Extensions interface that contains the collection.

Return value

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

The object identifier for this attribute is XCN_OID_RSA_certExtensions (1.2.840.113549.1.9.14). For more information, see CERTENROLL_OBJECTID.

You must call either InitializeEncode or InitializeDecode before you can use an IX509AttributeExtensions object. The two methods complement each other. The InitializeEncode method enables you to construct an encoded Abstract Syntax Notation One (ASN.1) structure from raw data, and the InitializeDecode method enables you to initialize raw data from an encoded ASN.1 structure that contains the certificate extensions. You can call the X509Extensions property to retrieve the extensions.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

See also

IX509Attribute

IX509AttributeExtensions

IX509Attributes