ICertificatePolicy::Initialize method (certenroll.h)

Article
02/22/2024

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

Syntax

HRESULT Initialize(
  [in] IObjectId *pValue
);

Parameters

[in] pValue

Pointer to an IObjectId interface that represents the OID.

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.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	The object is already initialized.

Remarks

You must use an initialized IObjectId object when calling this method. All of the IObjectId initialization methods search the registry and static memory on the local computer and Active Directory on the domain server for the first OID that matches the specified initialization parameters. You can retrieve the OID by calling the ObjectId property.

When you call the Initialize method, an empty IPolicyQualifiers object is created. You can retrieve the object by calling the PolicyQualifiers property. You can use the object to define policy qualifiers if you are creating a CertificatePolicies extension.

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