SetSignProcessCNGKeyByHandle
安全與簽章
描述
把呼叫者擁有的 NCRYPT_KEY_HANDLE 與其 DER 編碼的 X.509 憑證附加到 PDF 簽署程序
此路徑支援由應用程式專屬的探索、原則或雲端提供者程式碼開啟的金鑰,不必再按名稱重新開啟
語法
Delphi
Function TPDFlib.SetSignProcessCNGKeyByHandle(SignProcessID: Integer; Const CertificateDER: AnsiString; KeyHandle: TPLIntPtr; AllowUI: Boolean): Integer;
參數
| CertificateDER | 與該金鑰對應的完整 DER 編碼 RSA 或 ECDSA X.509 憑證 |
|---|---|
| KeyHandle | 以 TPLIntPtr 表示的已開啟 NCRYPT_KEY_HANDLE |
| AllowUI | true 表示簽署時允許提供者互動 |
傳回值
| 1 | 借用的控制代碼已接到程序 |
|---|---|
| 0 | process id、憑證或控制代碼無效 |
備註
所有權仍在呼叫者手上,控制碼必須保持有效直到 EndSignProcessTo* 完成
程式庫在簽署前查詢 NCrypt 演算法群組,並以提供的憑證驗證完成的 CMS 簽章
這種控制碼尺寸的 API 僅 Delphi 可用;DLL 與 ActiveX 呼叫者請用提供者加金鑰名稱的 API