共用方式為


CertSelectionGetSerializedBlob 函式 (cryptuiapi.h)

CertSelectionGetSerializedBlob 函式是協助程式函式,用來從CERT_SELECTUI_INPUT結構擷取序列化憑證 BLOB

語法

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 參數所指向的緩衝區中收到的 BLOB 大小 (以位元組為單位)。

返回值

如果函式成功,函式會傳回 S_OK

如果函式失敗,它會傳回指出錯誤的 HRESULT 值。 如果 hStoreprgpChain 參數都不是 NULL,則傳回 E_INVALIDARG。 如需常見錯誤碼的清單,請參閱 常見的 HRESULT 值

備註

傳回的序列化 BLOB 會傳遞至 pvInAuthBuffer 參數中的 CredUIPromptForWindowsCredentials 函式,以允許使用者使用認證選取 UI 來選取憑證。

在此函式的 ppOutBuffer 參數所指向的緩衝區中傳回的 BLOB 中序列化的憑證相依於 CERT_SELECTUI_INPUT 結構的 hStoreprgpChain 成員的值。

h商店 prgp鏈 序列化的憑證
NULL 不是 空值 prgpChain 成員所指向的憑證會序列化。
不是 空值 NULL hStore 成員所指定的憑證會序列化。
NULL NULL 傳回空的 BLOB。
不是 空值 不是 空值 呼叫失敗,函式傳回 E_INVALIDARG

需求

Requirement 價值觀
最低支援的用戶端 Windows 7 [僅限桌面應用程式]
支援的最低伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平臺 窗戶
Header cryptuiapi.h
Library 密碼UI.lib
DLL Cryptui.dll