Applies to: desktop apps only
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.
Windows 2000: Certificate Services interfaces do not support free threading.
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 |
|---|
|
Minimum supported server
| Windows 2000 Server |
|---|
|
Header
|
- Certenc.h (include Certsrv.h)
|
|---|
|
Library
|
- Certidl.lib
|
|---|
|
DLL
|
- Certenc.dll
|
|---|
|
IID
|
IID_ICertEncodeAltName is defined as 1c9a8c70-1271-11d1-9bd4-00c04fb683fa
|
|---|
Send comments about this topic to Microsoft
Build date: 3/6/2012