SIP_SUBJECTINFO-Struktur (mssip.h)
Die SIP_SUBJECTINFO-Struktur gibt Betreffinformationsdaten für die SIP-APIs ( Subject Interface Package ) an.
Syntax
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;
Member
cbSize
Die Größe (in Bytes) dieser Struktur.
pgSubjectType
Ein Zeiger auf eine GUID-Struktur , die den Antragstellertyp identifiziert.
hFile
Ein Dateihandle, das den Betreff darstellt. Wenn der Speichertyp des Antragstellers eine Datei ist, legen Sie hFile auf INVALID_HANDLE_VALUE und den parameter pwsFileName auf den Namen der Datei fest.
pwsFileName
Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Dateinamen des Antragstellers enthält.
pwsDisplayName
Ein Zeiger auf eine Unicode-Zeichenfolge, die null endet und den Anzeigenamen des Antragstellers enthält.
dwReserved1
Dieses Element ist für die zukünftige Verwendung reserviert.
dwIntVersion
Dieser Member ist reserviert. Ändern Sie dieses Element nicht. Sie wird vom SIP verwendet, um die interne Versionsnummer zwischen get- und verify-Funktionen zu übergeben.
hProv
Ein HCRYPTPROV-Handle für den Kryptografieanbieter.
DigestAlgorithm
Eine CRYPT_ALGORITHM_IDENTIFIER-Struktur , die den Bezeichner für den Hashalgorithmus enthält, der zum Hashen der Datei verwendet wird.
dwFlags
Ein -Wert, der das Verhalten der Funktionen ändert, die diese Struktur verwenden. Weitere Informationen zu möglichen Werten für diesen Member finden Sie im dwFlags-Parameter von SignerSignEx.
dwEncodingType
Ein -Wert, der den für die Datei verwendeten Codierungstyp angibt. Derzeit werden nur X509_ASN_ENCODING und PKCS_7_ASN_ENCODING verwendet. In Zukunft können jedoch weitere Codierungstypen hinzugefügt werden. Verwenden Sie für einen der aktuellen Codierungstypen: X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.
dwReserved2
Dieses Element ist für die zukünftige Verwendung reserviert.
fdwCAPISettings
Dieser Member wird nicht verwendet.
fdwSecuritySettings
Dieser Member wird nicht verwendet.
dwIndex
Der Nachrichtenindex des letzten Aufrufs von CryptSIPGetSignedDataMsg. ausgeführt werden müssen.
dwUnionChoice
Gibt den Typ der bereitgestellten zusätzlichen Informationen an.
| Definierte Konstante/Wert | Bedeutung |
|---|---|
|
Es gibt keine zusätzlichen Informationen zum Thema. |
|
Die zusätzlichen Informationen sind eine Flatfile. |
|
Die zusätzlichen Informationen sind ein Katalogelement. |
|
Die zusätzlichen Informationen sind ein BLOB. |
|
Die zusätzlichen Informationen haben ein benutzerdefiniertes Format. |
psFlat
Eine MS_ADDINFO_FLAT-Struktur , die zusätzliche Informationen für Flatfile-Betrefftypen enthält.
psCatMember
Eine MS_ADDINFO_CATALOGMEMBER-Struktur , die zusätzliche Informationen zu Thementypen für Katalogmember enthält.
psBlob
Eine MS_ADDINFO_BLOB-Struktur , die zusätzliche Informationen zu BLOB-Betrefftypen enthält.
psDetachedSig
pClientData
Ein Zeiger auf SIP-spezifische Daten.
Hinweise
Initialisieren Sie bei der ersten Verwendung der SIP_SUBJECTINFO-Struktur die gesamte Struktur auf binär null. Initialisieren Sie die Struktur nicht zwischen SIP-Funktionsaufrufen.
Zu den Themen gehören portable ausführbare Images (.exe), Cabinet(.cab), Flatfiles und Katalogdateien. Jeder Antragstellertyp verwendet eine andere Teilmenge seiner Daten für die Hashberechnung und erfordert eine andere Prozedur zum Speichern und Abrufen. Daher verfügt jeder Antragstellertyp über eine eindeutige Spezifikation des Antragstellerschnittstellenpakets.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | mssip.h |