Функция 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 .

hStore	prgpChain	Сериализованные сертификаты
NULL	не NULL	Сертификаты, на которые указывает член prgpChain , сериализуются.
не NULL	NULL	Сертификаты, указанные членом hStore , сериализуются.
NULL	NULL	Возвращается пустой BLOB-объект.
не NULL	не NULL	Вызов завершается ошибкой, и функция возвращает E_INVALIDARG.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 7 [только настольные приложения]
минимальный поддерживаемый сервер	Windows Server 2008 R2 [только классические приложения]
целевая платформа	Виндоус
Header	cryptuiapi.h
Library	cryptui.lib
DLL	Cryptui.dll