Expand Minimize

CertRDNValueToStr function

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

Syntax


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

Parameters

dwValueType [in]

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
pValue [in]

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

psz [out]

A pointer to a buffer to receive the returned string.

csz [in]

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Wincrypt.h

Library

Crypt32.lib

DLL

Crypt32.dll

Unicode and ANSI names

CertRDNValueToStrW (Unicode) and CertRDNValueToStrA (ANSI)

See also

Data Conversion Functions
CertNameToStr

 

 

Community Additions

ADD
Show:
© 2014 Microsoft