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

Статья
08/27/2023

Функция CertSerializeCertificateStoreElement сериализует закодированный сертификат контекста сертификата и его закодированные свойства. Результат можно сохранить в хранилище, чтобы получить сертификат и свойства позже.

Синтаксис

BOOL CertSerializeCertificateStoreElement(
  [in]      PCCERT_CONTEXT pCertContext,
  [in]      DWORD          dwFlags,
  [out]     BYTE           *pbElement,
  [in, out] DWORD          *pcbElement
);

Параметры

[in] pCertContext

Указатель на CERT_CONTEXT для сериализации.

[in] dwFlags

Зарезервировано для будущего использования и должно быть равно нулю.

[out] pbElement

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

Этот параметр может иметь значение NULL , чтобы задать размер этих сведений для целей выделения памяти. Дополнительные сведения см. в разделе Извлечение данных неизвестной длины.

[in, out] pcbElement

Указатель на значение DWORD , указывающее размер (в байтах) буфера, на который указывает параметр pbElement . Когда функция возвращает значение DWORD , содержит количество байтов, хранящихся в буфере.

Примечание При обработке данных, возвращаемых в буфере, приложения должны использовать фактический размер возвращаемых данных. Фактический размер может быть немного меньше размера буфера, указанного во входных данных. (На входных данных размеры буфера обычно указываются достаточно большими, чтобы убедиться, что максимально возможные выходные данные помещаются в буфер.) В выходных данных переменная, на которую указывает этот параметр, обновляется с учетом фактического размера данных, скопированных в буфер.

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

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

Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	wincrypt.h
Библиотека	Crypt32.lib
DLL	Crypt32.dll

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

CertAddSerializedElementToStore

Функции сертификата

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