SignerTimeStampEx3 函式
SignerTimeStampEx3函式時間戳記指定的主體,並支援在多個簽章上設定時間戳記。
注意
此函式沒有相關聯的標頭檔或匯入程式庫。 若要呼叫此函式,您必須建立使用者定義的標頭檔,並使用 LoadLibrary 和 GetProcAddress 函式動態連結至 Mssign32.dll。
語法
HRESULT WINAPI SignerTimeStampEx3(
_In_ DWORD dwFlags,
_In_ DWORD dwIndex,
_In_ SIGNER_SUBJECT_INFO *pSubjectInfo,
_In_ PCWSTR pwszHttpTimeStamp,
_In_ PCWSTR pszAlgorithmOid,
_In_opt_ PCRYPT_ATTRIBUTES psRequest,
_In_opt_ PVOID pSipData,
_Out_ SIGNER_CONTEXT **ppSignerContext,
_In_opt_ PCERT_STRONG_SIGN_PARA pCryptoPolicy,
_Reserved_ PVOID pReserved
);
參數
-
dwFlags [in]
-
指定要產生之時間戳記類型的旗標。 此參數可以是下列其中一個值。 這些值互斥。
值 意義 SIGNER_TIMESTAMP_AUTHENTICODE 指定 Authenticode 時間戳記。
注意: Authenticode 不再是慣用的時間戳記類型。 未來可能會移除 Authenticode 時間戳記的支援。 建議您改用 RFC 3161。- SIGNER_TIMESTAMP_RFC3161
指定符合 RFC 3161 規範的時間戳記。 -
dwIndex [in]
-
指定將新增時間戳記之簽章的序號。 如果此值為零 (0) ,外部簽章將會時間戳記。
-
pSubjectInfo [in]
-
SIGNER_SUBJECT_INFO 結構的位址 ,表示要加上時間戳記的主體。
-
pwszHttpTimeStamp [in]
-
Null 終止 Unicode 字串的位址,其中包含時間戳記伺服器的 URL。
-
pszAlgorithmOid [in]
-
用來執行符合 RFC 3161 規範時間戳記的雜湊演算法。 Authenticode 時間戳記會忽略此參數。
-
psRequest [in, optional]
-
選擇性。 包含新增至時間戳記要求之其他屬性 的CRYPT_ATTRIBUTES 結構位址。
此參數是選擇性的,如果不包含此參數,則可以是 Null 。
-
pSipData [in, optional]
-
選擇性。 傳遞為其他資料的 32 位值,以 主體介面套件 (SIP) 函式。 此參數的格式和內容是由 SIP 提供者所定義。
此參數是選擇性的,如果不包含此參數,則可以是 Null 。
-
ppSignerCoNtext [out]
-
選擇性。 包含已簽署 BLOB 之 SIGNER_CONTEXT 結構的指標位址。 當您完成使用 SIGNER_CONTEXT 結構時,請呼叫 SignerFreeSignerCoNtext 函式來釋放它。
-
pCryptoPolicy [in, optional]
-
如果有, 則為CERT_STRONG_SIGN_PARA 結構的指標,其中包含用來檢查強式簽章的參數。 時間戳記必須傳遞此密碼編譯原則。
-
保存
-
保留的。 此值必須是 Null。
傳回值
如果函式成功,函式會傳回S_OK。
如果函式失敗,它會傳回 HRESULT 值,指出錯誤。 此函式傳回的可能錯誤碼包括,但不限於下列各項。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
傳回碼 | Description |
---|---|
|
針對下列情況,可以傳回此錯誤:
|
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2012 [僅限傳統型應用程式] |
DLL |
|
另請參閱