Fonction CertModifyCertificatesToTrust (cryptdlg.h)

Article
03/02/2024

La fonction CertModifyCertificatesToTrust modifie l’ensemble de certificats dans une liste d’approbation de certificats (CTL) dans un but donné.

Note Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers CryptDlg.dll.

Syntaxe

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
);

Paramètres

[in] cCerts

Nombre de demandes de modification qui se trouvent dans le paramètre rgCerts .

[in] rgCerts

Pointeur vers une structure CTL_MODIFY_REQUEST qui contient un tableau de demandes de modification.

[in] szPurpose

Pointeur vers une chaîne terminée par null qui contient la représentation sous forme de chaîne d’un identificateur d’objet (OID). L’OID spécifie l’utilisation améliorée de la clé (EKU) de la CTL à modifier.

[in] hwnd

Handle de la fenêtre parente des boîtes de dialogue générées par cette fonction.

[in, optional] hcertstoreTrust

Handle du magasin de certificats dans lequel modifier la liste des certificats approuvés. Si la valeur est NULL, le magasin de Personnes approuvé est utilisé avec l’emplacement utilisateur actuel.

[in, optional] pccertSigner

Pointeur vers une structure CERT_CONTEXT qui contient un certificat. Il est utilisé pour signer la liste d’approbation. Le certificat restreint également l’ensemble de listes d’approbation qui peuvent être modifiées. Si la valeur est NULL, la liste d’approbation n’est pas signée.

Valeur retournée

HRESULT. Une valeur de S_OK indique la réussite.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	cryptdlg.h
DLL	CryptDlg.dll

Voir aussi

CTL_MODIFY_REQUEST

Partager via