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 值，指出錯誤。 如果 hStore 和 prgpChain 參數都不是 NULL，請 傳回E_INVALIDARG。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

備註

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

此函式的 ppOutBuffer 參數所指向之緩衝區中串行化的憑證，取決於CERT_SELECTUI_INPUT 結構之 hStore 和 prgpChain 成員的值。

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