ICertEncodeStringArray interface
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.
Members
The ICertEncodeStringArray interface inherits from the IDispatch interface. ICertEncodeStringArray also has these types of members:
Methods
The ICertEncodeStringArray interface has these methods.
| Method | Description |
|---|---|
| Decode |
Decodes an Abstract Syntax Notation One (ASN.1)-encoded string array and stores the resulting array of strings in the COM object. |
| Encode |
Performs ASN.1 encoding on a string array stored in the COM object and returns the ASN.1-encoded string array. |
| GetCount |
Returns the number of values in a string array. |
| GetStringType |
Returns the type of values contained in a string array. |
| GetValue |
Returns the value at a specified index of a string array. |
| Reset |
Resets a string array to a specified type and number of elements, and clears the values. |
| SetValue |
Sets a value at a specified index of a string array. |
Requirements
|
Minimum supported client | None supported [desktop apps only] |
|---|---|
|
Minimum supported server | Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
IID |
IID_ICertEncodeStringArray is defined as 12a88820-7494-11d0-8816-0a0c903b83cc |
Send comments about this topic to Microsoft
Build date: 10/26/2012