共用方式為


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 參數所指向之緩衝區中串行化的憑證,取決於CERT_SELECTUI_INPUT 結構之 hStoreprgpChain 成員的值。

hStore prgpChain 串行化的憑證
NULL NULL prgpChain 成員所指向的憑證會串行化。
NULL NULL hStore 成員指定的憑證會串行化。
NULL NULL 傳回空的 BLOB。
NULL NULL 呼叫失敗,且函式會傳回 E_INVALIDARG

規格需求

需求
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 cryptuiapi.h
Dll Cryptui.dll