Funzione CertRDNValueToStrA (wincrypt.h)

  • Articolo

La funzione CertRDNValueToStr converte un nome in un CERT_RDN_VALUE_BLOB in una stringa di caratteri con terminazione Null.

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.

I valori possibili sono i 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 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 NULL di terminazione. Se psz è NULL o csz è zero, restituisce le dimensioni necessarie della stringa di destinazione.

Commenti

Se psz non è NULL e csz non è zero, psz restituito è sempre una stringa con terminazione Null eventualmente vuota.

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincrypt.h
Libreria Crypt32.lib
DLL Crypt32.dll

Vedi anche

CertNameToStr

Funzioni di conversione dei dati