Fungsi SignerTimeStampEx3

Artikel
06/13/2023

Waktu fungsi SignerTimeStampEx3 memberi stempel subjek yang ditentukan dan mendukung pengaturan stempel waktu pada beberapa tanda tangan.

Catatan

Fungsi ini tidak memiliki file header atau pustaka impor terkait. Untuk memanggil fungsi ini, Anda harus membuat file header yang ditentukan pengguna dan menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Mssign32.dll.

Sintaks

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
);

Parameter

dwFlags [in]

Bendera yang menentukan jenis stempel waktu yang akan dihasilkan. Parameter ini bisa menjadi salah satu nilai berikut. Nilainya saling eksklusif.

Nilai	Makna
SIGNER_TIMESTAMP_AUTHENTICODE	Menentukan stempel waktu Authenticode. Catatan: Authenticode bukan lagi jenis stempel waktu yang disukai. Dukungan untuk stempel waktu Authenticode dapat dihapus di masa mendatang. Kami menyarankan agar Anda menggunakan RFC 3161 sebagai gantinya.
SIGNER_TIMESTAMP_RFC3161	Menentukan stempel waktu yang sesuai dengan RFC 3161.

dwIndex [in]

Menentukan nomor urut tanda tangan tempat tanda waktu akan ditambahkan. Jika nilai ini nol (0), tanda tangan luar akan diberi stempel waktu.

pSubjectInfo [in]

Alamat struktur SIGNER_SUBJECT_INFO yang mewakili subjek yang akan diberi stempel waktu.

pwszHttpTimeStamp [in]

Alamat string Unicode yang dihentikan null yang berisi URL server stempel waktu.

pszAlgorithmOid [in]

Algoritma hash yang akan digunakan untuk melakukan stempel waktu yang sesuai dengan RFC 3161. Parameter ini diabaikan untuk stempel waktu Authenticode.

psRequest [in, opsional]

Opsional. Alamat struktur CRYPT_ATTRIBUTES yang berisi atribut tambahan yang ditambahkan ke permintaan stempel waktu.

Parameter ini bersifat opsional dan dapat berupa NULL jika tidak disertakan.

pSipData [in, opsional]

Pilihan. Nilai 32-bit yang diteruskan sebagai data tambahan ke fungsi paket antarmuka subjek (SIP). Format dan konten parameter ini ditentukan oleh penyedia SIP.

Parameter ini bersifat opsional dan dapat berupa NULL jika tidak disertakan.

ppSignerContext [out]

Pilihan. Alamat pointer ke struktur SIGNER_CONTEXT yang berisi BLOB yang ditandatangani. Setelah Anda selesai menggunakan struktur SIGNER_CONTEXT , bebaskan dengan memanggil fungsi SignerFreeSignerContext .

pCryptoPolicy [in, opsional]

Jika ada, pointer ke struktur CERT_STRONG_SIGN_PARA yang berisi parameter yang digunakan untuk memeriksa tanda tangan yang kuat. Stempel waktu harus melewati kebijakan kriptografi ini.

Diawetkan

Dicadangkan. Nilai ini harus NULL.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Kemungkinan kode kesalahan yang dikembalikan oleh fungsi ini meliputi, tetapi tidak terbatas pada, berikut ini. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Menampilkan kode	Deskripsi
E_INVALIDARG	Kesalahan ini dapat dikembalikan untuk kondisi berikut: Anda harus mengatur SIGNER_TIMESTAMP_AUTHENTICODE atau SIGNER_TIMESTAMP_RFC3161 untuk parameter dwFlags . Parameter pReserved harus NULL. Jika Anda mengatur bendera SIGNER_TIMESTAMP_AUTHENTICODE di parameter dwFlags , Anda harus mengatur parameter dwIndex ke nol.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
DLL	Mssign32.dll

Lihat juga

SignerTimeStamp
SignerTimeStampEx
SignerTimeStampEx2

Bagikan melalui