ICertEncodeAltName interface
The ICertEncodeAltName interface provides methods for handling alternate names used in certificate extensions.
A certificate extension can be created using an alternate name array stored in an extension handler COM object. Each element in the array is a structure that contains a name string and a name choice.
This interface is useful for encoding and decoding szOID_SUBJECT_ALT_NAME2 "2.5.29.17" extensions; the SDK sample policy module uses this interface.
ICertEncodeAltName is defined in Certenc.h. When you create your program, however, use Certsrv.h as the include file. Certenc.dll provides the ICertEncodeAltName interface. The type information for this interface is also in Certencl.dll, which is shipped with the Platform Software Development Kit (SDK).
Certificate Services interfaces support both apartment-threading and free-threading models. For better throughput, free threading is recommended.
Members
The ICertEncodeAltName interface inherits from the IDispatch interface. ICertEncodeAltName also has these types of members:
Methods
The ICertEncodeAltName interface has these methods.
| Method | Description |
|---|---|
| Decode |
Decodes an Abstract Syntax Notation One (ASN.1)-encoded alternate name extension and stores the resulting array of strings in the extension handler. |
| Encode |
Performs ASN.1 encoding on an alternate name array stored in the extension handler and returns the name array as an array of ASN.1-encoded strings. |
| GetName |
Returns the alternate name at a specified index of an alternate name array. |
| GetNameChoice |
Returns a name choice at a specified index of an alternate name array. |
| GetNameCount |
Returns the count of names in an alternate name array. |
| Reset |
Resets an alternate name array to a specified number of elements and clears the values. |
| SetNameEntry |
Sets a name and name choice at a specified index of an alternate name array. |
Requirements
|
Minimum supported client | None supported [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
IID |
IID_ICertEncodeAltName is defined as 1c9a8c70-1271-11d1-9bd4-00c04fb683fa |
Send comments about this topic to Microsoft
Build date: 10/26/2012
