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.

MethodDescription
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 Server 2003 [desktop apps only]

Header

Certenc.h (include Certsrv.h)

Library

Certidl.lib

DLL

Certenc.dll

IID

IID_ICertEncodeAltName is defined as 1c9a8c70-1271-11d1-9bd4-00c04fb683fa

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.