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.

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