CertRDNValueToStr (Windows Embedded CE 6.0)

1/6/2010

This function converts a name in a CERT_RDN_VALUE_BLOB structure to a NULL-terminated character string.

Syntax

DWORD WINAPI CertRDNValueToStr(
  DWORD dwValueType,
  PCERT_RDN_VALUE_BLOB pValue,
  LPTSTR psz,
  DWORD csz
);

Parameters

• dwValueType
  [in] Specifies the kind of RDN value to be converted. This parameter can have 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

• pValue
  [in] Pointer to a CERT_RDN_VALUE_BLOB structure of a type appropriate for the dwValueType parameter.

• psz
  [out] Pointer to a buffer to receive the returned string.

• csz
  [in] Size, in characters, allocated for the returned string.

Return Value

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

Remarks

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

Requirements

See Also

Reference

Certificates Functions
CertNameToStr
BLOB (Cryptography)