WintrustAddActionID-Funktion (wintrust.h)

[Die WintrustAddActionID-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie für die Zertifikatüberprüfung die Funktionen CertGetCertificateChain und CertVerifyCertificateChainPolicy . Verwenden Sie für die Signaturüberprüfung der Microsoft Authenticode-Technologie die .NET Framework.]

Die WintrustAddActionID-Funktion fügt dem System des Benutzers eine Vertrauensanbieteraktion hinzu. Diese Methode sollte während der DllRegisterServer-Implementierung des Vertrauensanbieters aufgerufen werden. Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Wintrust.dll.

Diese Methode sollte nur von einem Vertrauensanbieter aufgerufen werden.

Syntax

BOOL WintrustAddActionID(
  [in] GUID                    *pgActionID,
  [in] DWORD                   fdwFlags,
  [in] CRYPT_REGISTER_ACTIONID *psProvInfo
);

Parameter

[in] pgActionID

Ein Zeiger auf eine GUID-Struktur , die die hinzuzufügende Aktion und den Vertrauensanbieter identifiziert, der diese Aktion unterstützt.

Der WinTrust-Dienst ist für die Zusammenarbeit mit Vertrauensanbietern konzipiert, die von Drittanbietern implementiert wurden. Jeder Vertrauensanbieter stellt seinen eigenen eindeutigen Satz von Aktionsbezeichnern bereit. Informationen zu den Aktionsbezeichnern, die von einem Vertrauensanbieter unterstützt werden, finden Sie in der Dokumentation zu diesem Vertrauensanbieter.

Microsoft stellt beispielsweise einen Software Publisher Trust Provider bereit, der die Vertrauenswürdigkeit von Software, die aus dem Internet oder einem anderen öffentlichen Netzwerk heruntergeladen wird, feststellen kann. Der Software Publisher Trust Provider unterstützt die folgenden Aktionsbezeichner. Diese Konstanten sind in Softpub.h definiert.

Wert	Bedeutung
WINTRUST_ACTION_GENERIC_VERIFY	Überprüfen Sie nur eine Zertifikatkette.
WINTRUST_ACTION_GENERIC_VERIFY_V2	Überprüfen Sie eine Datei oder ein Objekt mithilfe des Authenticode-Richtlinienanbieters.
HTTPSPROV_ACTION	Überprüfen Sie eine SSL/PCT-Verbindung über das Internet Explorer.

[in] fdwFlags

ein Wert, der bestimmt, ob Registrierungsfehler von dieser Funktion gemeldet werden. Wenn fdwFlags null ist und bei dieser Funktion ein Registrierungsfehler auftritt, wird der Registrierungsfehler nicht an die GetLastError-Funktion weitergegeben. Wenn fdwFlags WT_ADD_ACTION_ID_RET_RESULT_FLAG (0x1) ist und diese Funktion einen Registrierungsfehler auftritt, wird der Registrierungsfehler an die GetLastError-Funktion weitergegeben.

[in] psProvInfo

Ein Zeiger auf die CRYPT_REGISTER_ACTIONID Struktur, die die Informationen für den Vertrauensstellungsanbieter definiert.

Rückgabewert

Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist. FALSE , wenn die Funktion fehlschlägt. Wenn die Funktion fehlschlägt, rufen Sie die GetLastError-Funktion auf, um den Grund für den Fehler zu ermitteln. Informationen zu Registrierungsfehlern, die bei dieser Funktion auftreten können, finden Sie in der Beschreibung für fdwFlags.

Hinweise

Um eine Aktion zu entfernen, die von dieser Funktion hinzugefügt wurde, rufen Sie die WintrustRemoveActionID-Funktion auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wintrust.h
Bibliothek	Wintrust.lib
DLL	Wintrust.dll

Weitere Informationen

WintrustRemoveActionID