Funzione GetFriendlyNameOfCertA (cryptdlg.h)

Articolo
11/20/2024

[La funzione GetFriendlyNameOfCert è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. 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 una libreria di importazione associata. È necessario usare le funzioni di LoadLibrary e GetProcAd dress 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 di terminazione.

Valore restituito

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

Osservazioni

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 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 [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	cryptdlg.h
dll	CryptDlg.dll

Condividi tramite