Fungsi CryptSIPPutSignedDataMsg (mssip.h)

  • Artikel

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