Edit

IObjectId::InitializeFromName method (certenroll.h)

  • Article

The InitializeFromName method initializes the object from a CERTENROLL_OBJECTID enumeration value. This method is web enabled.

Syntax

HRESULT InitializeFromName(
  [in] CERTENROLL_OBJECTID Name
);

Parameters

[in] Name

A CERTENROLL_OBJECTID enumeration 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 OID information could not be found.
CRYPT_E_UNKNOWN_ALGO
 The algorithm name is not recognized.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 The object is already initialized.

Remarks

Every CERTENROLL_OBJECTID value is associated with an ASN.1 object identifier. For example, the value XCN_OID_ECDSA_SHA1 is associated with a string that contains 1.2.840.10045.4.1. This is the dotted decimal representation of the iso(1)member-body(2)us(840)10045 signatures(4)sha1(1) object identifier.

The InitializeFromName method searches the registry for information associated with the ASN.1 object identifier. If information is found, the method internally populates a CRYPT_OID_INFO structure and associates it with the object. The method also uses the local information to initialize, if possible, the display name of the object.

You can call the following properties to retrieve information about an initialized IObjectId object:

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

FriendlyName

IObjectID