Funzione CertRDNValueToStrA (wincrypt.h)

Articolo
11/20/2024

La funzione di CertRDNValueToStr converte un nome in un CERT_RDN_VALUE_BLOB in un nullstringa di caratteri con terminazione.

Sintassi

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

Parametri

[in] dwValueType

Indica il tipo di valore RDN da convertire.

Può trattarsi di uno dei valori seguenti:

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

Puntatore a un CERT_RDN_VALUE_BLOB di un tipo appropriato per il dwValueType.

[out] psz

Puntatore a un buffer per ricevere la stringa restituita.

[in] csz

Dimensione, in caratteri, allocata per la stringa restituita. Le dimensioni devono includere il carattere null di terminazione.

Valore restituito

Restituisce il numero di caratteri convertiti, incluso il carattere di terminazione null. Se psz è NULL o csz è zero, restituisce le dimensioni necessarie della stringa di destinazione.

Osservazioni

Se psz non è null e csz non è zero, il restituito psz è sempre un null-terminate stringa.

Nota

L'intestazione wincrypt.h definisce CertRDNValueToStr come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	wincrypt.h
libreria	Crypt32.lib
dll	Crypt32.dll

Vedere anche

CertNameToStr

funzioni di conversione dei dati

Condividi tramite