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

Статья
08/27/2023

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

Синтаксис

BOOL CertSerializeCTLStoreElement(
  [in]      PCCTL_CONTEXT pCtlContext,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbElement,
  [in, out] DWORD         *pcbElement
);

Параметры

[in] pCtlContext

Указатель на сериализуемую CTL_CONTEXT структуру.

[in] dwFlags

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

[out] pbElement

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

Этот параметр может иметь значение 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

Функции списка доверия сертификатов

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