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 值。 如果 hStore 和 prgpChain 參數都不是 NULL,則傳回 E_INVALIDARG。 如需常見錯誤碼的清單,請參閱 常見的 HRESULT 值。
備註
傳回的序列化 BLOB 會傳遞至 pvInAuthBuffer 參數中的 CredUIPromptForWindowsCredentials 函式,以允許使用者使用認證選取 UI 來選取憑證。
在此函式的 ppOutBuffer 參數所指向的緩衝區中傳回的 BLOB 中序列化的憑證相依於 CERT_SELECTUI_INPUT 結構的 hStore 和 prgpChain 成員的值。
| 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 |