DrtRegisterKey, fonction (drt.h)
La fonction DrtRegisterKey inscrit une clé dans la DRT.
Syntaxe
HRESULT DrtRegisterKey(
[in] HDRT hDrt,
[in] DRT_REGISTRATION *pRegistration,
[in, optional] PVOID pvKeyContext,
[out] HDRT_REGISTRATION_CONTEXT *phKeyRegistration
);
Paramètres
[in] hDrt
Pointeur vers un handle retourné par la fonction DrtOpen .
[in] pRegistration
Pointeur vers un handle vers la structure DRT_REGISTRATION .
[in, optional] pvKeyContext
Pointeur vers les données de contexte associées à la clé dans la DRT. Ces données sont transmises aux fonctions spécifiques à la clé du fournisseur de sécurité.
[out] phKeyRegistration
Pointeur vers un handle pour une clé qui a été inscrite.
Valeur retournée
Cette fonction retourne S_OK en cas de réussite. D’autres valeurs possibles sont les suivantes :
Code de retour | Description |
---|---|
|
|
|
hDrt est un handle non valide ou phKeyRegistration est un handle non valide |
|
La taille de la valeur cb du membre clé de la structure DRT_REGISTRATION n’est pas égale à 256 bits ou la valeur pbdu membre clé de la structure DRT_REGISTRATION est NULL.. |
|
Le cloud DRT est à l’état défectueux. |
|
La clé est déjà inscrite. |
|
La chaîne de certification fournie n’est pas valide. |
|
Le fournisseur de certificats fourni n’est pas compatible avec AES. |
|
La clé fournie ne correspond pas à la clé générée. |
|
Adresse valide introuvable. |
|
Le transport s’arrête. |
|
Le fournisseur de transport a la valeur NULL. |
|
Le transport n’est pas attaché. |
|
Le fournisseur de sécurité n’est pas attaché. |
|
Le transport n’est actuellement pas lié. |
|
Le système est en mémoire insuffisante. |
|
|
|
Une erreur irrécupérable inattendue s’est produite. |
Notes
Un nœud peut inscrire des clés dans l’état DRT_ACTIVE, DRT_ALONE ou DRT_NO_NETWORK . Toutefois, les clés inscrites dans les états DRT_ALONE et DRT_NO_NETWORK ne peuvent être reconnues par d’autres drts qu’après la transition du nœud local vers DRT_ACTIVE.
Pour mettre à jour une clé existante, une application doit d’abord annuler l’inscription de la clé auprès de DrtUnregisterKey avant d’appeler DrtRegisterKey pour inscrire la clé mise à jour.
Spécifications
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 | Drt.lib |
DLL | Drt.dll |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour