Skip to content

Latest commit

 

History

History
146 lines (116 loc) · 4.03 KB

nf-cryptuiapi-certselectiongetserializedblob.md

File metadata and controls

146 lines (116 loc) · 4.03 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:cryptuiapi.CertSelectionGetSerializedBlob
CertSelectionGetSerializedBlob function (cryptuiapi.h)
A helper function used to retrieve a serialized certificate BLOB from a CERT_SELECTUI_INPUT structure.
CertSelectionGetSerializedBlob
CertSelectionGetSerializedBlob function [Security]
cryptuiapi/CertSelectionGetSerializedBlob
security.certselectiongetserializedblob
security\certselectiongetserializedblob.htm
security
6c3240f7-5121-401d-a4d4-df3055cb301a
12/05/2018
CertSelectionGetSerializedBlob, CertSelectionGetSerializedBlob function [Security], cryptuiapi/CertSelectionGetSerializedBlob, security.certselectiongetserializedblob
cryptuiapi.h
Windows
Windows 7 [desktop apps only]
Windows Server 2008 R2 [desktop apps only]
Cryptui.dll
Windows
19H1
CertSelectionGetSerializedBlob
cryptuiapi/CertSelectionGetSerializedBlob
c++
APIRef
kbSyntax
DllExport
Cryptui.dll
Ext-MS-Win-security-cryptui-l1-1-0.dll
ext-ms-win-security-cryptui-l1-1-1.dll
CertCredProviderOneCore.dll
CertSelectionGetSerializedBlob

CertSelectionGetSerializedBlob function

-description

The CertSelectionGetSerializedBlob function is a helper function used to retrieve a serialized certificate BLOB from a CERT_SELECTUI_INPUT structure.

-parameters

-param pcsi [in]

A pointer to a CERT_SELECTUI_INPUT structure that contains the certificate store and certificate context chain information.

-param ppOutBuffer [out]

The address of a pointer to a buffer that receives the serialized certificates BLOB.

-param pulOutBufferSize [out]

A pointer to a ULONG to receive the size, in bytes, of the BLOB received in the buffer pointed to by the ppOutBuffer parameter.

-returns

If the function succeeds, the function returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. If both hStore and prgpChain parameters are not NULL, return E_INVALIDARG. For a list of common error codes, see Common HRESULT Values.

-remarks

The returned serialized BLOB is passed to the CredUIPromptForWindowsCredentials function in the pvInAuthBuffer parameter to allow a user to select a certificate by using the credential selection UI.

The certificates that are serialized in the BLOB returned in the buffer pointed to by the ppOutBuffer parameter of this function are dependent on the values of the hStore and prgpChain members of the CERT_SELECTUI_INPUT structure.

hStore prgpChain Certificates serialized
NULL not NULL The certificates pointed to by the prgpChain member are serialized.
not NULL NULL The certificates specified by the hStore member are serialized.
NULL NULL An empty BLOB is returned.
not NULL not NULL The call fails and the function returns E_INVALIDARG.