SIP_SUBJECTINFO 結構 (mssip.h)

  • 發行項

SIP_SUBJECTINFO 結構會指定主體介面套件的主體資訊數據， (SIP) API。

語法

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;

成員

cbSize

這個結構的大小，以位元組為單位。

pgSubjectType

識別主體類型的 GUID 結構的指標。

hFile

表示主旨的檔案句柄。 如果主旨的儲存類型是檔案，請將 hFile 設定為 INVALID_HANDLE_VALUE ，並將 pwsFileName 參數設定為檔名。

pwsFileName

包含主體檔名之 Null 終止 Unicode 字串的指標。

pwsDisplayName

包含主旨顯示名稱之 Null 終止 Unicode 字串的指標。

dwReserved1

這個成員保留供未來使用。

dwIntVersion

此成員已保留。 請勿修改此成員。 SIP 會使用它來傳遞 get 和 verify 函式之間的內部版本號碼。

hProv

密碼編譯提供者的 HCRYPTPROV 句柄。

DigestAlgorithm

CRYPT_ALGORITHM_IDENTIFIER 結構，其中包含用來哈希檔案之哈希演算法的標識碼。

dwFlags

值，修改使用此結構之函式的行為。 如需此成員可能值的詳細資訊，請參閱 SignerSignEx 的 dwFlags 參數。

dwEncodingType

值，指定用於檔案的編碼類型。 目前只會使用 X509_ASN_ENCODING 和 PKCS_7_ASN_ENCODING ;不過，未來可能會新增其他編碼類型。 針對目前的編碼類型，請使用： X509_ASN_ENCODING | PKCS_7_ASN_ENCODING。

dwReserved2

這個成員保留供未來使用。

fdwCAPISettings

未使用這個成員。

fdwSecuritySettings

未使用這個成員。

dwIndex

最後呼叫 CryptSIPGetSignedDataMsg 的訊息索引。 事件。

dwUnionChoice

指定提供的其他信息類型。

已定義的常數/值 意義
MSSIP_ADDINFO_NONE
0
 主旨沒有其他資訊。
MSSIP_ADDINFO_FLAT
1
 其他資訊是一般檔案。
MSSIP_ADDINFO_CATMEMBER
2
 其他資訊是目錄成員。
MSSIP_ADDINFO_BLOB
3
 其他資訊是 BLOB。
MSSIP_ADDINFO_NONMSSIP
500
 其他資訊的格式為使用者定義格式。

psFlat

MS_ADDINFO_FLAT 結構，其中包含一般檔案主體類型的其他資訊。

psCatMember

包含目錄成員主體類型其他資訊的 MS_ADDINFO_CATALOGMEMBER 結構。

psBlob

包含 BLOB 主體類型其他資訊的 MS_ADDINFO_BLOB 結構。

psDetachedSig

pClientData

SIP 特定數據的指標。

備註

第一次使用 SIP_SUBJECTINFO 結構時，請將整個結構初始化為二進位零。 請勿初始化 SIP 函式呼叫之間的結構。

主體包括但不限於可攜式可執行檔映像 (.exe) 、封包 (.cab) 影像、一般檔案和目錄檔案。 每個主體類型都會使用不同的數據子集進行哈希計算，而且需要不同的程式來儲存和擷取。 因此，每個主體類型都有唯一的主體介面套件規格。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 mssip.h