Edit

ICertEncodeStringArray::Reset method (certenc.h)

  • Article

The Reset method specifies the size of the string array and the type of strings the array will contain.The values of all the elements in the string array are set to zero.

You must call this method before calling the ICertEncodeStringArray::SetValue method for the first time.

Syntax

HRESULT Reset(
  [in] LONG Count,
  [in] LONG StringType
);

Parameters

[in] Count

Specifies the number of elements in the string array.

[in] StringType

Specifies the type of strings that the string array contains. The type must be one of the following values. For more information about RDN types, see the CryptoAPI 2.0 documents.

Value Meaning
CERT_RDN_ANY_TYPE
 For encoding an X509_UNICODE_NAME name.
CERT_RDN_NUMERIC_STRING
 The characters 0 through 9 and the space character (8 bit).
CERT_RDN_PRINTABLE_STRING
 Printable characters (8 bit).
CERT_RDN_T61_STRING
 T.61 encoded characters (8 bit).
CERT_RDN_VIDEOTEX_STRING
 VIDEOTEX characters.
CERT_RDN_IA5_STRING
 IA5 (ASCII) characters.
CERT_RDN_GRAPHIC_STRING
 A string of ISO-defined GRAPHIC characters.
CERT_RDN_ISO646_STRING
 128 character set (8 bit).
CERT_RDN_GENERAL_STRING
 A string of ISO-defined GENERAL characters.
CERT_RDN_INT4_STRING
 An array of INT4 values (32 bit).
CERT_RDN_UNICODE_STRING
 Unicode characters (16 bit).

Return value

VB

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

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)
Library Certidl.lib
DLL Certenc.dll

See also

ICertEncodeStringArray