Fungsi CryptSIPPutSignedDataMsg (mssip.h)

Artikel
03/08/2023

Fungsi CryptSIPPutSignedDataMsg menyimpan tanda tangan Authenticode dalam file target.

Sintaks

BOOL CryptSIPPutSignedDataMsg(
  [in]  SIP_SUBJECTINFO *pSubjectInfo,
  [in]  DWORD           dwEncodingType,
  [out] DWORD           *pdwIndex,
  [in]  DWORD           cbSignedDataMsg,
  [in]  BYTE            *pbSignedDataMsg
);

Parameter

[in] pSubjectInfo

Penunjuk ke struktur SIP_SUBJECTINFO yang berisi informasi tentang subjek pesan.

[in] dwEncodingType

Jenis pengodean pesan. Ini bisa menjadi kombinasi dari satu atau beberapa nilai berikut.

Nilai	Makna
PKCS_7_ASN_ENCODING 65536 (0x10000)	Menentukan pengodean pesan PKCS #7 .
X509_ASN_ENCODING 1 (0x1)	Menentukan pengodean sertifikat X.509 .

[out] pdwIndex

Arahkan ke indeks pesan.

[in] cbSignedDataMsg

Panjang, dalam byte, dari buffer yang diarahkan oleh parameter pbSignedDataMsg .

[in] pbSignedDataMsg

Penunjuk ke buffer yang berisi pesan.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError. Beberapa kemungkinan kode kesalahan mengikuti.

Menampilkan kode	Deskripsi
ERROR_BAD_FORMAT	Format data atau file yang ditentukan dari paket antarmuka subjek (SIP) tidak valid.
ERROR_INVALID_PARAMETER	Kode ini dapat dikembalikan karena alasan berikut: pSubjectInfo adalah NULL. pdwIndex adalah NULL. pbSignedDataMsg adalah NULL. Nilai parameter cbSignedDataMsg kurang dari satu. [SIP_SUBJECTINFO] Struktur (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo). [SIP_SUBJECTINFO] Struktur (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo).
TRUST_E_SUBJECT_FORM_UNKNOWN	Tipe subjek yang ditentukan tidak valid.

Keterangan

Setiap jenis subjek menggunakan subset data yang berbeda untuk perhitungan hash dan memerlukan prosedur yang berbeda untuk penyimpanan dan pengambilan. Oleh karena itu, setiap jenis subjek memiliki spesifikasi SIP yang unik.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	mssip.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll

Lihat juga

CryptSIPGetSignedDataMsg

CryptSIPRemoveSignedDataMsg

Bagikan melalui