Edit

Share via

IX509Attribute::Initialize method (certenroll.h)

  • Article

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

See also

ICryptAttribute

IX509Attribute

IX509Attributes