CertRDNValueToStrA-Funktion (wincrypt.h)

  • Artikel

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.

Hinweis

Der wincrypt.h-Header definiert CertRDNValueToStr als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincrypt.h
Bibliothek Crypt32.lib
DLL Crypt32.dll

Weitere Informationen

CertNameToStr

Datenkonvertierungsfunktionen