CertRDNValueToStrA-Funktion (wincrypt.h)
Die CertRDNValueToStr-Funktion wandelt einen Namen in einer CERT_RDN_VALUE_BLOB in eine NULL--terminated-Zeichenzeichenfolge um.
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.
Dies kann einer der folgenden Werte sein:
- 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 die dwValueType-geeignet ist.
[out] psz
Ein Zeiger auf einen Puffer, um die zurückgegebene Zeichenfolge zu empfangen.
[in] csz
Größe der zurückgegebenen Zeichenfolge in Zeichen. Die Größe muss das beendende NULL-Zeichen Zeichen enthalten.
Rückgabewert
Gibt die Anzahl der konvertierten Zeichen zurück, einschließlich des endenden NULL-zeichens Zeichens. Wenn psz-null ist oder csz- null ist, wird die erforderliche Größe der Zielzeichenfolge zurückgegeben.
Bemerkungen
Wenn psz nicht NULL- ist und csz- nicht null ist, ist die zurückgegebene psz- immer eine möglicherweise leere null-terminated string.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | wincrypt.h |
| Library | Crypt32.lib |
| DLL- | Crypt32.dll |