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

Статья
08/22/2023

Функция CertModifyCertificatesToTrust изменяет набор сертификатов в списке доверия сертификатов (CTL) для определенной цели.

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

Синтаксис

CRYPTDLGAPI HRESULT CertModifyCertificatesToTrust(
  [in]           int                 cCerts,
  [in]           PCTL_MODIFY_REQUEST rgCerts,
  [in]           LPCSTR              szPurpose,
  [in]           HWND                hwnd,
  [in, optional] HCERTSTORE          hcertstoreTrust,
  [in, optional] PCCERT_CONTEXT      pccertSigner
);

Параметры

[in] cCerts

Количество запросов на изменение, которые находятся в параметре rgCerts .

[in] rgCerts

Указатель на структуру CTL_MODIFY_REQUEST , содержащую массив запросов на изменение.

[in] szPurpose

Указатель на строку, завершающуюся нулевым значением, которая содержит строковое представление идентификатора объекта (OID). OID указывает расширенное использование ключа (EKU) изменяемого CTL.

[in] hwnd

Дескриптор родительского окна диалоговых окон, создаваемых этой функцией.

[in, optional] hcertstoreTrust

Дескриптор хранилища сертификатов, в котором необходимо изменить список доверенных сертификатов. Если значение РАВНО NULL, хранилище доверенных Люди используется с расположением текущего пользователя.

[in, optional] pccertSigner

Указатель на структуру CERT_CONTEXT , содержащую сертификат. Он используется для подписывания списка доверия. Сертификат также ограничивает набор списков доверия, которые могут быть изменены. Если значение РАВНО NULL, список доверия не подписывается.

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

HRESULT. Значение S_OK указывает на успешное выполнение.

Требования

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

См. также раздел

CTL_MODIFY_REQUEST

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