GetFriendlyNameOfCertA function (cryptdlg.h)
[The GetFriendlyNameOfCert function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use the CertGetNameString function with the CERT_NAME_FRIENDLY_DISPLAY_TYPE flag.]
The GetFriendlyNameOfCert function retrieves the display name for a certificate.
Syntax
CRYPTDLGAPI DWORD GetFriendlyNameOfCertA(
[in] PCCERT_CONTEXT pccert,
[out] LPSTR pch,
[in] DWORD cch
);
Parameters
[in] pccert
A pointer to the certificate context whose display name is being retrieved.
[out] pch
A pointer to a character string that receives the display name for the certificate.
[in] cch
Number of characters allocated for pchBuffer, including the terminating NULL character.
Return value
The return value is the number of characters, including the terminating NULL character, in the returned display name.
Remarks
Note
The cryptdlg.h header defines GetFriendlyNameOfCert as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows XP [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | cryptdlg.h |
DLL | CryptDlg.dll |