Funzione CertRDNValueToStrW (wincrypt.h)

  • Articolo

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

Sintassi

DWORD CertRDNValueToStrW(
  [in]  DWORD                dwValueType,
  [in]  PCERT_RDN_VALUE_BLOB pValue,
  [out] LPWSTR               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

Dimensioni, in caratteri, allocati per la stringa restituita. Le dimensioni devono includere il carattere NULL terminante.

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, la psz restituita è sempre una stringa con terminazione null 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

   
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