CertRDNValueToStrA function (wincrypt.h)

The CertRDNValueToStr function converts a name in a CERT_RDN_VALUE_BLOB to a null-terminated character string.

Syntax

DWORD CertRDNValueToStrA(
  [in]  DWORD                dwValueType,
  [in]  PCERT_RDN_VALUE_BLOB pValue,
  [out] LPSTR                psz,
  [in]  DWORD                csz
);

Parameters

[in] dwValueType

Indicates the kind of RDN value to be converted.

This can be one of the following values:

• CERT_RDN_ANY_TYPE
• CERT_RDN_ENCODED_BLOB
• CERT_RDN_OCTET_STRING
• CERT_RDN_NUMERIC_STRING
• CERT_RDN_PRINTABLE_STRING
• CERT_RDN_TELETEX_STRING
• CERT_RDN_T61_STRING
• CERT_RDN_VIDEOTEX_STRING
• CERT_RDN_IA5_STRING
• CERT_RDN_GRAPHIC_STRING
• CERT_RDN_VISIBLE_STRING
• CERT_RDN_ISO646_STRING
• CERT_RDN_GENERAL_STRING
• CERT_RDN_UNIVERSAL_STRING
• CERT_RDN_INT4_STRING
• CERT_RDN_BMP_STRING
• CERT_RDN_UNICODE_STRING
• CERT_RDN_UTF8_STRING

[in] pValue

A pointer to an CERT_RDN_VALUE_BLOB of a type appropriate for the dwValueType.

[out] psz

A pointer to a buffer to receive the returned string.

[in] csz

Size, in characters, allocated for the returned string. The size must include the terminating NULL character.

Return value

Returns the number of characters converted, including the terminating NULL character. If psz is NULL or csz is zero, returns the required size of the destination string.

Remarks

If psz is not NULL and csz is not zero, the returned psz is always a possibly empty null-terminated string.

Requirements

See also

CertNameToStr

Data Conversion Functions