IX509Attribute::Initialize method (certenroll.h)

Article
10/13/2021

The Initialize method initializes the object from an object identifier (OID) and a value.

Syntax

HRESULT Initialize(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parameters

[in] pObjectId

Pointer to an IObjectId interface that contains the attribute OID.

[in] Encoding

An EncodingType enumeration value that specifies the type of Unicode encoding applied to the attribute value contained in the strEncodedData parameter.

[in] strEncodedData

A BSTR variable that contains the attribute value.

Return value

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. Possible values include, but are not limited to, those in the following table. For a list of common error codes, see Common HRESULT Values.

Return code/value	Description
CERTSRV_E_PROPERTY_EMPTY	The pointer to the IObjectId interface is NULL.

Remarks

You must initialize the IObjectId object by calling the InitializeFromName or InitializeFromValue methods before using it in this method.

Call the ObjectId property to retrieve the OID. Call the RawData property to retrieve the attribute value.

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