ICertEncodeStringArray interface (certenc.h)

The ICertEncodeStringArray interface provides methods for handling string arrays used in certificate extensions.

A certificate extension can be created by using a string array stored in an extension handler COM object instantiated by the policy module. Each element in the array is a string value.

This interface is provided mainly as a demonstration for encoding custom extensions. The Certificate Services sample programs in the Platform Software Development Kit (SDK) contain source code for this interface.

ICertEncodeStringArray is defined in Certenc.h. When you create your program, however, use Certsrv.h as the include file. Certenc.dll provides the ICertEncodeStringArray interface. The type information for this interface is also in Certencl.dll, which is shipped with the Platform SDK.

Certificate Services interfaces support both apartment-threading and free-threading models. For better throughput, free threading is recommended.

Inheritance

The ICertEncodeStringArray interface inherits from the IDispatch interface. ICertEncodeStringArray also has these types of members:

Methods

The ICertEncodeStringArray interface has these methods.

ICertEncodeStringArray::Decode Decodes an Abstract Syntax Notation One (ASN.1)-encoded string array and stores the resulting array of strings in the CertEncodeStringArray object.
ICertEncodeStringArray::Encode Returns an ASN.1-encoded string of the string array stored in this object.
ICertEncodeStringArray::GetCount Returns the number of string values in the string array.
ICertEncodeStringArray::GetStringType Returns the type of string values that the string array contains.
ICertEncodeStringArray::GetValue Returns the specified string from the string array.
ICertEncodeStringArray::Reset Specifies the size of the string array and the type of strings the array will contain.
ICertEncodeStringArray::SetValue Sets a string value at the specified index of the string array.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	certenc.h (include Certsrv.h)