Функция CertSelectionGetSerializedBlob (cryptuiapi.h)

Функция CertSelectionGetSerializedBlob является вспомогательной функцией, используемой для получения сериализованного BLOB-объекта сертификата из структуры CERT_SELECTUI_INPUT .

Синтаксис

HRESULT CertSelectionGetSerializedBlob(
  [in]  PCERT_SELECTUI_INPUT pcsi,
  [out] void                 **ppOutBuffer,
  [out] ULONG                *pulOutBufferSize
);

Параметры

[in] pcsi

Указатель на структуру CERT_SELECTUI_INPUT , содержащую сведения о хранилище сертификатов и контекстной цепочке сертификатов.

[out] ppOutBuffer

Адрес указателя на буфер, получающий сериализованные сертификаты BLOB.

[out] pulOutBufferSize

Указатель на ULONG для получения размера в байтах большого двоичного объекта, полученного в буфере, на который указывает параметр ppOutBuffer .

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

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

Если функция завершается ошибкой, она возвращает значение HRESULT , указывающее на ошибку. Если параметры hStore и prgpChain не имеют значения NULL, возвращается E_INVALIDARG. Список распространенных кодов ошибок см. в разделе "Общие значения HRESULT".

Замечания

Возвращаемый сериализованный BLOB-объект передается функции CredUIPromptForWindowsCredentials в параметре pvInAuthBuffer , чтобы разрешить пользователю выбрать сертификат с помощью пользовательского интерфейса выбора учетных данных.

Сертификаты, сериализованные в BLOB-объекте, возвращаемом в буфере, на которые указывает параметр ppOutBuffer этой функции, зависят от значений элементов hStore и prgpChain структуры CERT_SELECTUI_INPUT .

Требования