Функция GetFriendlyNameOfCertA (cryptdlg.h)

  • Статья

[Функция GetFriendlyNameOfCert доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. Вместо этого используйте функцию CertGetNameString с флагом CERT_NAME_FRIENDLY_DISPLAY_TYPE.]

Функция GetFriendlyNameOfCert извлекает отображаемое имя сертификата.

Примечание У этой функции нет связанной библиотеки импорта. Для динамического связывания с CryptDlg.dll необходимо использовать функции LoadLibrary и GetProcAddress .
 

Синтаксис

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

Параметры

[in] pccert

Указатель на контекст сертификата, отображаемое имя которого извлекается.

[out] pch

Указатель на строку символов, которая получает отображаемое имя сертификата.

[in] cch

Количество символов, выделенных для pchBuffer, включая завершающий символ NULL .

Возвращаемое значение

Возвращаемое значение — это количество символов, включая завершающий символ NULL в возвращаемом отображаемом имени.

Комментарии

Примечание

Заголовок cryptdlg.h определяет GetFriendlyNameOfCert в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header cryptdlg.h
DLL CryptDlg.dll