DrtCreateDerivedKeySecurityProvider, fonction (drt.h)

  • Article

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