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

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