CertModifyCertificatesToTrust-Funktion (cryptdlg.h)

Artikel
08/22/2023

Die CertModifyCertificatesToTrust-Funktion ändert den Satz von Zertifikaten in einer Zertifikatvertrauensliste (Certificate Trust List, CTL) für einen bestimmten Zweck.

Hinweis Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit CryptDlg.dll zu verknüpfen.

Syntax

CRYPTDLGAPI HRESULT CertModifyCertificatesToTrust(
  [in]           int                 cCerts,
  [in]           PCTL_MODIFY_REQUEST rgCerts,
  [in]           LPCSTR              szPurpose,
  [in]           HWND                hwnd,
  [in, optional] HCERTSTORE          hcertstoreTrust,
  [in, optional] PCCERT_CONTEXT      pccertSigner
);

Parameter

[in] cCerts

Die Anzahl der Änderungsanforderungen im rgCerts-Parameter .

[in] rgCerts

Ein Zeiger auf eine CTL_MODIFY_REQUEST-Struktur , die ein Array von Änderungsanforderungen enthält.

[in] szPurpose

Ein Zeiger auf eine NULL-endende Zeichenfolge, die die Zeichenfolgendarstellung eines Objektbezeichners (Object Identifier, OID) enthält. Die OID gibt die erweiterte Schlüsselverwendung (Enhanced Key Usage, EKU) der zu ändernden CTL an.

[in] hwnd

Ein Handle für das übergeordnete Fenster der Dialogfelder, die von dieser Funktion generiert werden.

[in, optional] hcertstoreTrust

Ein Handle für den Zertifikatspeicher, in dem die Liste der vertrauenswürdigen Zertifikate geändert werden soll. Bei NULL wird der Speicher für vertrauenswürdige Personen mit dem Aktuellen Benutzerspeicherort verwendet.

[in, optional] pccertSigner

Ein Zeiger auf eine CERT_CONTEXT-Struktur , die ein Zertifikat enthält. Sie wird verwendet, um die Vertrauensliste zu signieren. Das Zertifikat schränkt auch den Satz von Vertrauenslisten ein, die geändert werden können. Wenn NULL, ist die Vertrauensliste nicht signiert.

Rückgabewert

Ein HRESULT. Der Wert S_OK gibt den Erfolg an.

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	cryptdlg.h
DLL	CryptDlg.dll

Weitere Informationen

CTL_MODIFY_REQUEST

Freigeben über