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

Статья
11/20/2024

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

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

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

Синтаксис

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 [только классические приложения]
целевая платформа	Виндоус
заголовка	cryptdlg.h
DLL	CryptDlg.dll

Поделиться через