Функция CertAddCRLContextToStore (wincrypt.h)
Функция CertAddCRLContextToStore добавляет контекст списка отзыва сертификатов (CRL) в указанное хранилище сертификатов.
Синтаксис
BOOL CertAddCRLContextToStore(
[in] HCERTSTORE hCertStore,
[in] PCCRL_CONTEXT pCrlContext,
[in] DWORD dwAddDisposition,
[out, optional] PCCRL_CONTEXT *ppStoreContext
);
Параметры
[in] hCertStore
Дескриптор хранилища сертификатов.
[in] pCrlContext
Указатель на добавляемую структуру CRL_CONTEXT .
[in] dwAddDisposition
Указывает действие, которое необходимо выполнить, если соответствующий список отзыва сертификатов или ссылка на соответствующий список отзыва сертификатов уже существует в хранилище. В настоящее время определены значения ликвидации и их использование следующим образом.
| Значение | Значение |
|---|---|
|
Не проверка для существующего соответствующего списка отзыва сертификатов или ссылки на соответствующий список отзыва сертификатов. Новый список отзыва сертификатов всегда добавляется в магазин. Это может привести к дублированию в магазине. |
|
Если соответствующий список отзыва сертификатов или ссылка на соответствующий список отзыва сертификатов существует, операция завершается сбоем. GetLastError возвращает код CRYPT_E_EXISTS. |
|
Если соответствующий список отзыва сертификатов или ссылка на соответствующий список отзыва сертификатов существует, функция сравнивает время ThisUpdate для списков отзыва сертификатов. Если существующий список отзыва сертификатов имеет значение ThisUpdate меньше времени ThisUpdate в новом списке отзыва сертификатов, старый список отзыва сертификатов или ссылка заменяются так же, как и CERT_STORE_ADD_REPLACE_EXISTING. Если существующий список отзыва сертификатов имеет время ThisUpdate больше или равное времени ThisUpdate для добавляемого списка отзыва сертификатов, функция завершается сбоем с getLastError , возвращающим код CRYPT_E_EXISTS.
Если соответствующий список отзыва сертификатов или ссылка на соответствующий список отзыва сертификатов не найден в магазине, в магазин добавляется новый список отзыва сертификатов. |
|
Действие такое же, как и для CERT_STORE_ADD_NEWER, за исключением того, что при замене старого списка отзыва сертификатов свойства старого списка отзыва сертификатов включаются в список отзыва сертификатов на замену. |
|
Если соответствующий список отзыва сертификатов или ссылка на соответствующий список отзыва сертификатов существует, существующий список отзыва сертификатов или ссылка удаляются, а новый список отзыва сертификатов создается и добавляется в хранилище. Если соответствующий список отзыва сертификатов или ссылка на соответствующий список отзыва сертификатов не существует, он добавляется. |
|
Если соответствующий список отзыва сертификатов существует в хранилище, существующий контекст удаляется перед созданием и добавлением нового контекста. Добавленный контекст наследует свойства от существующего списка отзыва сертификатов. |
|
Если соответствующий список отзыва сертификатов или ссылка на соответствующий список отзыва сертификатов существует, используется существующий список отзыва сертификатов и добавляются свойства из нового списка отзыва сертификатов. Функция не завершается ошибкой, но новые списки отзыва сертификатов не добавляются. Если ppCertContext не имеет значение NULL, существующий контекст дублируется.
Если соответствующий список отзыва сертификатов или ссылка на соответствующий список отзыва сертификатов не существует, добавляется новый список отзыва сертификатов. |
[out, optional] ppStoreContext
Указатель на указатель на декодированный контекст списка отзыва сертификатов. Это необязательный параметр, который может иметь значение NULL, указывая, что вызывающей приложению не требуется копия добавленного или существующего списка отзыва сертификатов. Если копия сделана, этот контекст должен быть освобожден с помощью CertFreeCRLContext.
Возвращаемое значение
Если функция выполняется успешно, возвращается значение TRUE.
Если функция завершается сбоем, возвращается значение FALSE. В эту функцию можно распространить ошибки из вызываемых функций CertAddEncodedCRLToStore и CertSetCRLContextProperty .
Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError. Ниже приведены некоторые возможные коды ошибок.
| Код возврата | Описание |
|---|---|
|
Эта ошибка возвращается, если задано CERT_STORE_ADD_NEW и список отзыва сертификатов уже существует в хранилище или если задано CERT_STORE_ADD_NEWER и список отзыва сертификатов существует в хранилище с датой ThisUpdate , большей или равной дате ThisUpdate в добавляемом списке отзыва сертификатов. |
|
Параметр dwAddDisposition указывает недопустимое значение ликвидации. |
Комментарии
Контекст списка отзыва сертификатов не дублируется с помощью CertDuplicateCRLContext. Вместо этого создается новая копия, которая добавляется в хранилище. Помимо копирования закодированного списка отзыва сертификатов, функция копирует свойства контекста.
Чтобы удалить контекст CRL из хранилища сертификатов, используйте функцию CertDeleteCRLFromStore .
Требования
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | wincrypt.h |
| Библиотека | Crypt32.lib |
| DLL | Crypt32.dll |