SetSignProcessContentsEstimate

אבטחה וחתימות

תיאור

Configures the material sizes and safety margin used to estimate the signature /Contents capacityThe estimator combines the base CMS size with certificate-chain, revocation, and time-stamp requirements before the signature field is written

תחביר

Delphi

Function TPDFlib.SetSignProcessContentsEstimate(SignProcessID, CertificateChainBytes, CRLBytes, OCSPBytes, TimeStampTokenBytes, SafetyMarginPercent: Integer): Integer;

ActiveX

Function PDFlib::SetSignProcessContentsEstimate(SignProcessID As Long, CertificateChainBytes As Long, CRLBytes As Long, OCSPBytes As Long, TimeStampTokenBytes As Long, SafetyMarginPercent As Long) As Long

DLL

int DLSetSignProcessContentsEstimate(int InstanceID, int SignProcessID, int CertificateChainBytes, int CRLBytes, int OCSPBytes, int TimeStampTokenBytes, int SafetyMarginPercent);

פרמטרים

SignProcessID	Value returned by a `NewSignProcessFrom*` function
CertificateChainBytes	העבירו `-1` כדי לגלות את שרשרת התעודות שנותרה ממטמוני Windows המקומיים, `0` כדי להשמיט קיבולת נוספת לשרשרת, או ערך חיובי כדי לספק גודל מקודד צפוי
CRLBytes	המספר הכולל הצפוי של בתי DER עבור רשימות ביטול התוקף המתוכננות
OCSPBytes	Total expected DER bytes for planned OCSP responses
TimeStampTokenBytes	Expected DER size of a planned RFC 3161 time-stamp token
SafetyMarginPercent	Additional percentage from `0` through `100` applied before alignment

ערכי החזרה

1	תצורת ההערכה התקבלה
0	מזהה ה-process, גודל החומר, הגודל המצטבר או האחוז לא היו תקינים

הערות

תהליך חתימה חדש כברירת מחדל משתמש בגילוי שרשרת ממוטמנת, ללא חומרי ביטול או time-stamp מתוכננים, ועם מרווח בטיחות של 15 אחוז; חתימת PFX מקומית משתמשת בגודל CMS נמדד, בעוד שחתימות מחסן מערכת, CNG, Ed25519 ו-digest חיצוני גוזרות את גודל החתימה המרבי מהמפתח הציבורי של התעודה מבלי להפעיל מפתח פרטי או callback

Certificate-chain discovery is cache-only and never performs network retrievalThe result is aligned to 256 bytes and capped at 64 MiB, and

SetSignProcessReserveContentsBytes remains an additive manual reserve

ראה גם

GetSignProcessEstimatedContentsBytes, SetSignProcessReserveContentsBytes, SetPAdESSignatureTimeStampToken