Функция CertAddEncodedCertificateToSystemStoreW (wincrypt.h)

Статья
11/20/2024

Функция CertAddEncodedCertificateToSystemStore открывает указанное системное хранилище и добавляет в него закодированный сертификат.

Синтаксис

BOOL CertAddEncodedCertificateToSystemStoreW(
  [in] LPCWSTR    szCertStoreName,
  [in] const BYTE *pbCertEncoded,
  [in] DWORD      cbCertEncoded
);

Параметры

[in] szCertStoreName

Строка, завершающая значение NULL, содержащая имя системного хранилища для закодированного сертификата.

[in] pbCertEncoded

Указатель на буфер, содержащий добавленный в кодированный сертификат.

[in] cbCertEncoded

Размер в байтах буфера pbCertEncoded.

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

Если функция выполнена успешно, возвращаемое значение TRUE.

Если функция завершается ошибкой, возвращаемое значение FALSE. CertAddEncodedCertificateToSystemStore зависит от функций, перечисленных в следующих замечаниях для обработки ошибок. Ознакомьтесь с этими разделами функций для их соответствующих действий по обработке ошибок. Для получения расширенных сведений об ошибке вызовите GetLastError.

Замечания

Внутренне CertAddEncodedCertificateToSystemStore вызывает CertOpenSystemStore и CertAddEncodedCertificateToStore со следующими параметрами.

параметр CertOpenSystemStore	Ценность
szSubsystemProtocol	szCertStoreName

Если CertAddEncodedCertificateToSystemStore получает дескриптор в указанное системное хранилище, он вызывает CertCloseStore, чтобы закрыть дескриптор перед возвратом.

параметр CertAddEncodedCertificateToStore	Ценность
dwCertEncodingType	X509_ASN_ENCODING
dwAddDisposition	CERT_STORE_ADD_USE_EXISTING
ppCertContext	NULL

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	wincrypt.h
библиотеки	Crypt32.lib
DLL	Crypt32.dll

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