DrtCreateDerivedKeySecurityProvider, fonction (drt.h)

Article
03/01/2024

La fonction DrtCreateDerivedKeySecurityProvider crée le fournisseur de sécurité de clé dérivée pour une table de routage distribuée.

Syntaxe

HRESULT DrtCreateDerivedKeySecurityProvider(
  [in]  PCCERT_CONTEXT        pRootCert,
  [out] PCCERT_CONTEXT        pLocalCert,
        DRT_SECURITY_PROVIDER **ppSecurityProvider
);

Paramètres

[in] pRootCert

Pointeur vers le certificat qui est la partie « racine » de la chaîne. Cela permet de s’assurer que les clés dérivées de la même chaîne peuvent être vérifiées.

[out] pLocalCert

Pointeur vers le module DRT_SECURITY_PROVIDER à inclure dans la structure DRT_SETTINGS .

ppSecurityProvider

Reçoit un pointeur vers le fournisseur de sécurité créé.

Valeur retournée

Cette fonction retourne S_OK en cas de réussite. D’autres valeurs possibles sont les suivantes :

Code de retour	Description
E_INVALIDARG	pRootCert a la valeur NULL.
E_OUTOFMEMORY	Le système n’a pas pu allouer de mémoire au fournisseur de sécurité.
DRT_E_CAPABILITY_MISMATCH	Les algorithmes de sécurité demandés ne sont pas disponibles ( par exemple. BCRYPT_SHA256_ALGORITHM ou BCRYPT_AES_ALGORITHM). L’opération BCryptOpenAlgorithmProvider a échoué. Le paramètre dwProvType indique que le fournisseur de certificat n’est pas compatible avec AES.
DRT_E_INVALID_CERT_CHAIN	Aucun magasin de certificats n’est attaché ou il existe une erreur dans la chaîne de certificats.

Remarques

Le fournisseur de sécurité créé par cette fonction est spécifique à la DRT pour laquelle il a été créé. Il ne peut pas être partagé par plusieurs instances DRT.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	drt.h
Bibliothèque	Drtprov.lib
DLL	Drt.dll

Voir aussi

DRT_REGISTRATION

DRT_SETTINGS

DrtCreateDerivedKey

DrtDeleteDerivedKeySecurityProvider

Partager via