Edit

ICertPropertyKeyProvInfo::Initialize method (certenroll.h)

  • Article

The Initialize method initializes the object from a private key.

Syntax

HRESULT Initialize(
  [in] IX509PrivateKey *pValue
);

Parameters

[in] pValue

Pointer to an IX509PrivateKey interface that represents the private key.

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 IX509PrivateKey pointer is NULL.
ERROR_ARITHMETIC_OVERFLOW
 The unique container name and the provider name are too long.

Remarks

Call the SetValueOnCertificate method to associate the property with a certificate. Call the PrivateKey property to retrieve the key.

The Initialize method opens the private key and verifies that the following IX509PrivateKey properties are set:

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

ICertProperty

ICertPropertyKeyProvInfo