Fungsi SignerTimeStampEx

Artikel
06/13/2023

Waktu fungsi SignerTimeStampEx memberi stempel subjek yang ditentukan dan secara opsional mengembalikan penunjuk ke struktur SIGNER_CONTEXT yang berisi penunjuk ke BLOB. Fungsi ini mendukung stempel waktu Authenticode. Untuk melakukan stempel waktu X.509 Public Key Infrastructure (RFC 3161), gunakan fungsi SignerTimeStampEx2 .

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 SignerTimeStampEx(
  _Reserved_ DWORD               dwFlags,
  _In_       SIGNER_SUBJECT_INFO *pSubjectInfo,
  _In_       LPCWSTR             pwszHttpTimeStamp,
  _In_       PCRYPT_ATTRIBUTES   psRequest,
  _In_       LPVOID              pSipData,
  _Out_      SIGNER_CONTEXT      **ppSignerContext 
);

Parameter

dwFlags [in]

Dicadangkan. Parameter ini harus diatur ke nol.

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.

psRequest [in]

Pilihan. 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]

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 .

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan S_OK.

Jika fungsi gagal, fungsi mengembalikan nilai HRESULT yang menunjukkan kesalahan. Untuk daftar kode kesalahan umum, lihat Nilai HRESULT Umum.

Persyaratan

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

Lihat juga


SignerTimeStamp