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.
[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 |