WINTRUST_DATA-Struktur (wintrust.h)
[Die WINTRUST_DATA-Struktur ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Die WINTRUST_DATA-Struktur wird beim Aufrufen von WinVerifyTrust verwendet, um die erforderlichen Informationen an die Vertrauensanbieter zu übergeben.
Syntax
typedef struct _WINTRUST_DATA {
DWORD cbStruct;
LPVOID pPolicyCallbackData;
LPVOID pSIPClientData;
DWORD dwUIChoice;
DWORD fdwRevocationChecks;
DWORD dwUnionChoice;
union {
#if ...
WINTRUST_FILE_INFO_ *pFile;
#else
struct WINTRUST_FILE_INFO_ *pFile;
#endif
#if ...
WINTRUST_CATALOG_INFO_ *pCatalog;
#else
struct WINTRUST_CATALOG_INFO_ *pCatalog;
#endif
#if ...
WINTRUST_BLOB_INFO_ *pBlob;
#else
struct WINTRUST_BLOB_INFO_ *pBlob;
#endif
#if ...
WINTRUST_SGNR_INFO_ *pSgnr;
#else
struct WINTRUST_SGNR_INFO_ *pSgnr;
#endif
#if ...
WINTRUST_CERT_INFO_ *pCert;
#else
struct WINTRUST_CERT_INFO_ *pCert;
#endif
#if ...
WINTRUST_DETACHED_SIG_INFO_ *pDetachedSig;
#else
struct WINTRUST_DETACHED_SIG_INFO_ *pDetachedSig;
#endif
};
DWORD dwStateAction;
HANDLE hWVTStateData;
WCHAR *pwszURLReference;
DWORD dwProvFlags;
DWORD dwUIContext;
struct WINTRUST_SIGNATURE_SETTINGS_ *pSignatureSettings;
} WINTRUST_DATA, *PWINTRUST_DATA;
Member
cbStruct
Die Größe (in Bytes) dieser Struktur.
pPolicyCallbackData
Ein Zeiger auf einen Datenpuffer, der verwendet wird, um richtlinienspezifische Daten an einen Richtlinienanbieter zu übergeben. Dieses Element kann NULL sein.
pSIPClientData
Ein Zeiger auf einen Datenpuffer, der verwendet wird, um SIP-spezifische Daten ( Subject Interface Package ) an einen SIP-Anbieter zu übergeben. Dieses Element kann NULL sein.
dwUIChoice
Gibt die Art der zu verwendenden Benutzeroberfläche an. Dieser Member muss einer der folgenden Werte sein.
fdwRevocationChecks
Optionen für die Zertifikatsperrung. Dieses Element kann so festgelegt werden, dass die Sperrüberprüfung der vom ausgewählten Richtlinienanbieter durchgeführten Überprüfung hinzugefügt wird. Dieser Member muss einer der folgenden Werte sein.
Wert | Bedeutung |
---|---|
|
Es wird keine zusätzliche Sperrüberprüfung durchgeführt, wenn das WTD_REVOKE_NONE-Flag in Verbindung mit dem HTTPSPROV_ACTION Wert verwendet wird, der im pgActionID-Parameter der WinVerifyTrust-Funktion festgelegt ist. Um sicherzustellen, dass die WinVerifyTrust-Funktion beim Überprüfen von Codesignaturen keinen Netzwerkabruf versucht, muss WTD_CACHE_ONLY_URL_RETRIEVAL im dwProvFlags-Parameter festgelegt werden. |
|
Die Sperrüberprüfung wird in der gesamten Kette durchgeführt. |
dwUnionChoice
Gibt den zu verwendenden Union-Member und damit den Typ des Objekts an, für das die Vertrauenswürdigkeit überprüft wird. Dieser Member muss einer der folgenden Werte sein.
Wert | Bedeutung |
---|---|
|
Verwenden Sie die Datei, auf die von pFile verwiesen wird. |
|
Verwenden Sie den Katalog, auf den pCatalog verweist. |
|
Verwenden Sie das BLOB , auf das von pBlob verwiesen wird. |
|
Verwenden Sie die [WINTRUST_SGNR_INFO](/windows/desktop/api/wintrust/ns-wintrust-wintrust_sgnr_info)-Struktur, auf die pSgnr verweist. |
|
Verwenden Sie das Zertifikat, auf das von pCert verwiesen wird. |
pFile
Ein Zeiger auf eine WINTRUST_FILE_INFO-Struktur .
pCatalog
Ein Zeiger auf eine WINTRUST_CATALOG_INFO Struktur.
pBlob
Ein Zeiger auf eine WINTRUST_BLOB_INFO-Struktur .
pSgnr
Ein Zeiger auf eine WINTRUST_SGNR_INFO-Struktur .
pCert
Ein Zeiger auf eine WINTRUST_CERT_INFO Struktur.
pDetachedSig
dwStateAction
Gibt die auszuführende Aktion an. Dies kann einer der folgenden Werte sein.
hWVTStateData
Ein Handle für die Zustandsdaten. Der Inhalt dieses Members hängt vom Wert des dwStateAction-Members ab.
pwszURLReference
Für die zukünftige Verwendung reserviert. Auf NULL festgelegt.
dwProvFlags
DWORD-Wert , der Die Einstellungen des Vertrauensanbieters angibt. Dies kann eine bitweise Kombination aus 0 oder mehr der folgenden Werte sein.
Wert | Bedeutung |
---|---|
|
Die Vertrauensstellung wird auf die gleiche Weise überprüft wie von Internet Explorer 4.0 implementiert. |
|
Die Internet Explorer 4.0-Kettenfunktionalität wird nicht verwendet. |
|
Die Standardüberprüfung des Richtlinienanbieters, z. B. die Codesignatur für Authenticode, wird nicht ausgeführt, und das Zertifikat wird für alle Verwendungen gültig angenommen. |
|
Die Sperrüberprüfung wird nicht durchgeführt. |
|
Die Sperrüberprüfung wird nur für das Endzertifikat durchgeführt. |
|
Die Sperrüberprüfung wird für die gesamte Zertifikatkette durchgeführt. |
|
Die Sperrüberprüfung wird für die gesamte Zertifikatkette mit Ausnahme des Stammzertifikats durchgeführt. |
|
Wird nicht unterstützt. |
|
Nur der Hash wird überprüft. |
|
Die Standardversionsprüfung des Betriebssystems wird durchgeführt. Dieses Flag wird nur zum Überprüfen von katalogsignierten Dateien verwendet. |
|
Wenn dieses Flag nicht festgelegt ist, gelten alle Zeitstempelsignaturen als für immer gültig. Durch Festlegen dieses Flags wird die gültige Lebensdauer der Signatur auf die Lebensdauer des Signaturzertifikats beschränkt. Dadurch können Zeitstempelsignaturen ablaufen. |
|
Verwenden Sie nur den lokalen Cache für Sperrprüfungen. Verhindert Sperrüberprüfungen im Netzwerk.
Windows XP: Dieser Wert wird nicht unterstützt. |
|
Deaktivieren Sie die Verwendung von MD2- und MD4-Hashingalgorithmen. Wenn eine Datei mit MD2 oder MD4 signiert wird und dieses Flag festgelegt ist, wird ein NTE_BAD_ALGID-Fehler zurückgegeben.
Hinweis Dieses Flag wird unter Windows 7 mit SP1 und höheren Betriebssystemen unterstützt.
|
|
Wenn dieses Flag angegeben wird, wird davon ausgegangen, dass die zu überprüfende Datei aus dem Web heruntergeladen wurde und das Attribut "Mark" des Web-Attributs aufweist. Richtlinien, die auf die Markierung der Webdateien angewendet werden sollen, werden erzwungen.
Hinweis Dieses Flag wird auf Windows 8.1 und höheren Betriebssystemen oder auf Systemen unterstützt, die KB2862966 installiert haben.
|
dwUIContext
Ein DWORD-Wert , der den Benutzeroberflächenkontext für die WinVerifyTrust-Funktion angibt. Dadurch wird der Text im Dialogfeld Authenticode mit der für die Datei ausgeführten Aktion übereinstimmen. Dies kann einer der folgenden Werte sein.
Wert | Bedeutung |
---|---|
|
Verwenden Sie beim Aufrufen von WinVerifyTrust für eine Datei, die ausgeführt werden soll. Dies ist der Standardwert. |
|
Verwenden Sie beim Aufrufen von WinVerifyTrust für eine Datei, die installiert werden soll. |
pSignatureSettings
Zeiger auf eine WINTRUST_SIGNATURE_SETTINGS-Struktur .
Windows 8 und Windows Server 2012: Die Unterstützung für dieses Mitglied beginnt.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Kopfzeile | wintrust.h |