struktur SIP_SUBJECTINFO (mssip.h)

  • Artikel

Struktur SIP_SUBJECTINFO menentukan data informasi subjek ke API paket antarmuka subjek (SIP).

Sintaks

typedef struct SIP_SUBJECTINFO_ {
  DWORD                      cbSize;
  GUID                       *pgSubjectType;
  HANDLE                     hFile;
  LPCWSTR                    pwsFileName;
  LPCWSTR                    pwsDisplayName;
  DWORD                      dwReserved1;
  DWORD                      dwIntVersion;
  HCRYPTPROV                 hProv;
  CRYPT_ALGORITHM_IDENTIFIER DigestAlgorithm;
  DWORD                      dwFlags;
  DWORD                      dwEncodingType;
  DWORD                      dwReserved2;
  DWORD                      fdwCAPISettings;
  DWORD                      fdwSecuritySettings;
  DWORD                      dwIndex;
  DWORD                      dwUnionChoice;
  union {
#if ...
    MS_ADDINFO_FLAT_                 *psFlat;
#else
    struct MS_ADDINFO_FLAT_          *psFlat;
#endif
#if ...
    MS_ADDINFO_CATALOGMEMBER_        *psCatMember;
#else
    struct MS_ADDINFO_CATALOGMEMBER_ *psCatMember;
#endif
#if ...
    MS_ADDINFO_BLOB_                 *psBlob;
#else
    struct MS_ADDINFO_BLOB_          *psBlob;
#endif
#if ...
    MS_ADDINFO_DETACHEDSIG_          *psDetachedSig;
#else
    struct MS_ADDINFO_DETACHEDSIG_   *psDetachedSig;
#endif
  };
  LPVOID                     pClientData;
} SIP_SUBJECTINFO, *LPSIP_SUBJECTINFO;

Anggota

cbSize

Ukuran, dalam byte, dari struktur ini.

pgSubjectType

Penunjuk ke struktur GUID yang mengidentifikasi jenis subjek.

hFile

Handel file yang mewakili subjek. Jika jenis penyimpanan subjek adalah file, atur hFile ke INVALID_HANDLE_VALUE dan atur parameter pwsFileName ke nama file.

pwsFileName

Penunjuk ke string Unicode yang dihentikan null yang berisi nama file subjek.

pwsDisplayName

Penunjuk ke string Unicode yang dihentikan null yang berisi nama tampilan subjek.

dwReserved1

Anggota ini dicadangkan untuk digunakan di masa mendatang.

dwIntVersion

Anggota ini dicadangkan. Jangan ubah anggota ini. Ini digunakan oleh SIP untuk meneruskan nomor versi internal antara fungsi dapatkan dan verifikasi.

hProv

Handel HCRYPTPROV ke penyedia kriptografi.

DigestAlgorithm

Struktur CRYPT_ALGORITHM_IDENTIFIER yang berisi pengidentifikasi untuk algoritma hash yang digunakan untuk hash file.

dwFlags

Nilai yang memodifikasi perilaku fungsi yang menggunakan struktur ini. Untuk informasi selengkapnya tentang kemungkinan nilai untuk anggota ini, lihat parameter dwFlagssignerSignEx.

dwEncodingType

Nilai yang menentukan jenis pengodean yang digunakan untuk file. Saat ini, hanya X509_ASN_ENCODING dan PKCS_7_ASN_ENCODING yang digunakan; namun, jenis pengodean tambahan dapat ditambahkan di masa mendatang. Untuk jenis pengodean saat ini, gunakan: X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.

dwReserved2

Anggota ini dicadangkan untuk digunakan di masa mendatang.

fdwCAPISettings

Anggota ini tidak digunakan.

fdwSecuritySettings

Anggota ini tidak digunakan.

dwIndex

Indeks pesan dari panggilan terakhir ke CryptSIPGetSignedDataMsg. Operasi.

dwUnionChoice

Menentukan jenis informasi tambahan yang disediakan.

Konstanta/nilai yang ditentukan Makna
MSSIP_ADDINFO_NONE
0
 Tidak ada informasi tambahan tentang subjek.
MSSIP_ADDINFO_FLAT
1
 Informasi tambahan adalah file datar.
MSSIP_ADDINFO_CATMEMBER
2
 Informasi tambahan adalah anggota katalog.
MSSIP_ADDINFO_BLOB
3
 Informasi tambahan adalah BLOB.
MSSIP_ADDINFO_NONMSSIP
500
 Informasi tambahan dalam format yang ditentukan pengguna.

psFlat

Struktur MS_ADDINFO_FLAT yang berisi informasi tambahan untuk jenis subjek file datar.

psCatMember

Struktur MS_ADDINFO_CATALOGMEMBER yang berisi informasi tambahan untuk jenis subjek anggota katalog.

psBlob

Struktur MS_ADDINFO_BLOB yang berisi informasi tambahan untuk jenis subjek BLOB.

psDetachedSig

pClientData

Penunjuk ke data khusus SIP.

Keterangan

Setelah pertama kali menggunakan struktur SIP_SUBJECTINFO , inisialisasi seluruh struktur menjadi biner nol. Jangan menginisialisasi struktur antara panggilan fungsi SIP.

Subjek termasuk, tetapi tidak terbatas pada, gambar portabel yang dapat dieksekusi (.exe), gambar kabinet (.cab), file datar, dan file katalog. Setiap jenis subjek menggunakan subset data yang berbeda untuk perhitungan hash dan memerlukan prosedur penyimpanan dan pengambilan yang berbeda. Oleh karena itu setiap jenis subjek memiliki spesifikasi paket antarmuka subjek yang unik.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header mssip.h