Funzione GetFriendlyNameOfCertA (cryptdlg.h)

  • Articolo

[La funzione GetFriendlyNameOfCert è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece la funzione CertGetNameString con il flag CERT_NAME_FRIENDLY_DISPLAY_TYPE.]

La funzione GetFriendlyNameOfCert recupera il nome visualizzato per un certificato.

Nota Questa funzione non ha alcuna libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a CryptDlg.dll.
 

Sintassi

CRYPTDLGAPI DWORD GetFriendlyNameOfCertA(
  [in]  PCCERT_CONTEXT pccert,
  [out] LPSTR          pch,
  [in]  DWORD          cch
);

Parametri

[in] pccert

Puntatore al contesto del certificato il cui nome visualizzato viene recuperato.

[out] pch

Puntatore a una stringa di caratteri che riceve il nome visualizzato per il certificato.

[in] cch

Numero di caratteri allocati per pchBuffer, incluso il carattere NULL terminante.

Valore restituito

Il valore restituito è il numero di caratteri, incluso il carattere NULL terminante, nel nome visualizzato restituito.

Commenti

Nota

L'intestazione cryptdlg.h definisce GetFriendlyNameOfCert 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

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione cryptdlg.h
DLL CryptDlg.dll