Edit

IAlternativeName::InitializeFromRawData method (certenroll.h)

  • Article

The InitializeFromRawData method initializes the object from a Digital Signature Algorithm (DSA) GUID, an X.500 directory name, or an Internet Protocol (IP) address contained in a Distinguished Encoding Rules (DER) encoded byte array.

Syntax

HRESULT InitializeFromRawData(
  [in] AlternativeNameType Type,
  [in] EncodingType        Encoding,
  [in] BSTR                strRawData
);

Parameters

[in] Type

An AlternativeNameType enumeration value that identifies the type of name represented by the input string. This must be one of the following values.

Value Meaning
XCN_CERT_ALT_NAME_DIRECTORY_NAME
 The name is an X.500 directory name.
XCN_CERT_ALT_NAME_IP_ADDRESS
 The name is an IP address.
XCN_CERT_ALT_NAME_GUID
 The name is a GUID.

[in] Encoding

An EncodingType enumeration value that identifies the type of Unicode encoding applied to the strRawData parameter.

[in] strRawData

A BSTR variable that contains the DER-encoded data.

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

Remarks

The raw data is a byte array that has been encoded by using Distinguished Encoding Rules (DER). You must specify the byte array as a Unicode encoded string.

If you use this method to specify a DSA GUID (XCN_CERT_ALT_NAME_GUID), the GUID is associated with the XCN_OID_NTDS_REPLICATION (1.3.6.1.4.1.311.25.1) object identifier (OID) and encoded as an octet string (byte array). You can retrieve the OID by calling the ObjectId property. You can call the RawData property to retrieve the encoded byte array.

If you use this method to specify any of the following name types, the method returns E_INVALIDARG.

Value Description
XCN_CERT_ALT_NAME_UNKNOWN The name type is not identified.
XCN_CERT_ALT_NAME_RFC822_NAME The name is an email address.
XCN_CERT_ALT_NAME_DNS_NAME The name is a DNS name.
XCN_CERT_ALT_NAME_URL The name is a URL.
XCN_CERT_ALT_NAME_REGISTERED_ID The name is a registered OID.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME The name is a user principal name (UPN).
XCN_CERT_ALT_NAME_OTHER_NAME The name consists of an OID and a byte array.
 

You can use the InitializeFromOtherName method to specify an OID and a corresponding name string, and you can use the InitializeFromString method to specify an email address, a DNS name, a URL, a registered OID, or a user principal name (UPN).

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

IAlternativeName