CertRDNValueToStrA-Funktion (wincrypt.h)

Die CertRDNValueToStr-Funktion konvertiert einen Namen in einer CERT_RDN_VALUE_BLOB in eine null-endende Zeichenfolge.

Syntax

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

Parameter

[in] dwValueType

Gibt die Art des zu konvertierenden RDN-Werts an.

Mögliche Werte:

• 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

Ein Zeiger auf eine CERT_RDN_VALUE_BLOB eines Typs, der für dwValueType geeignet ist.

[out] psz

Ein Zeiger auf einen Puffer zum Empfangen der zurückgegebenen Zeichenfolge.

[in] csz

Größe in Zeichen, die für die zurückgegebene Zeichenfolge zugeordnet ist. Die Größe muss das abschließende NULL-Zeichen enthalten.

Rückgabewert

Gibt die Anzahl der konvertierten Zeichen zurück, einschließlich des abschließenden NULL-Zeichens . Wenn pszNULL oder csz null ist, gibt die erforderliche Größe der Zielzeichenfolge zurück.

Hinweise

Wenn psz nicht NULL und csz nicht null ist, ist die zurückgegebene psz immer eine möglicherweise leere null-beendete Zeichenfolge.

Anforderungen

Weitere Informationen

CertNameToStr

Datenkonvertierungsfunktionen