ICertPropertyKeyProvInfo::Initialize method (certenroll.h)
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 |
|---|---|
|
The IX509PrivateKey pointer is NULL. |
|
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 |