ICertEncodeStringArray::GetStringType method (certenc.h)

The GetStringType method returns the type of string values that the string array contains.

Syntax

HRESULT GetStringType(
  [out] LONG *pStringType
);

Parameters

[out] pStringType

A pointer to a Long that represents the string type. For a list of string types, see Remarks.

Return value

C++

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.

VB

The return value indicates the type of strings in the string array. For a list of string types, see Remarks.

Remarks

The following table lists the types of strings that the string array can contain. For more information about RDN types, see the CryptoAPI 2.0 documents.

String type Meaning
CERT_RDN_ANY_TYPE For encoding an X509_UNICODE_NAME name.
CERT_RDN_NUMERIC_STRING The numerals 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).
 

Examples

For an example that uses the GetStringType method, see the ICertEncodeStringArray::Encode method.

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

ICertEncodeStringArray::Reset