Fonction BCryptAddContextFunction (bcrypt.h)

Article
08/22/2023

[BCryptAddContextFunction est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La fonction BCryptAddContextFunction ajoute une fonction de chiffrement à la liste des fonctions prises en charge par un contexte CNG existant.

Syntaxe

NTSTATUS BCryptAddContextFunction(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] ULONG   dwPosition
);

Paramètres

[in] dwTable

Identifie la table de configuration dans laquelle le contexte existe. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
CRYPT_LOCAL	Le contexte existe dans la table de configuration de l’ordinateur local.
CRYPT_DOMAIN	Cette valeur n’est pas disponible pour l’utilisation.

[in] pszContext

Pointeur vers une chaîne Unicode terminée par null qui contient l’identificateur du contexte auquel ajouter la fonction.

[in] dwInterface

Identifie l’interface de chiffrement à laquelle ajouter la fonction. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Ajoutez la fonction à la liste des fonctions de chiffrement asymétrique.
BCRYPT_CIPHER_INTERFACE	Ajoutez la fonction à la liste des fonctions de chiffrement.
BCRYPT_HASH_INTERFACE	Ajoutez la fonction à la liste des fonctions de hachage.
BCRYPT_RNG_INTERFACE	Ajoutez la fonction à la liste des fonctions de générateur de nombres aléatoires.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Ajoutez la fonction à la liste des fonctions d’accord secret.
BCRYPT_SIGNATURE_INTERFACE	Ajoutez la fonction à la liste des fonctions de signature.
NCRYPT_KEY_STORAGE_INTERFACE	Ajoutez la fonction à la liste des fonctions de stockage clés.
NCRYPT_SCHANNEL_INTERFACE	Ajoutez la fonction à la liste des fonctions Schannel.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE	Ajoutez la fonction à la liste des suites de signature que Schannel acceptera pour TLS 1.2. Windows Vista et Windows Server 2008 : Cette valeur n’est pas prise en charge.

[in] pszFunction

Pointeur vers une chaîne Unicode terminée par null qui contient l’identificateur de la fonction de chiffrement à ajouter.

[in] dwPosition

Spécifie la position dans la liste à laquelle insérer cette fonction. La fonction est insérée à cette position avant toutes les fonctions existantes. La valeur CRYPT_PRIORITY_TOP est utilisée pour insérer la fonction en haut de la liste. La valeur CRYPT_PRIORITY_BOTTOM est utilisée pour insérer la fonction à la fin de la liste.

Valeur retournée

Retourne un code status qui indique la réussite ou l’échec de la fonction.

Les codes de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
STATUS_SUCCESS	La fonction a réussi.
STATUS_INVALID_PARAMETER	Un ou plusieurs paramètres ne sont pas valides.
STATUS_NO_MEMORY	Un échec d’allocation de mémoire s’est produit.
STATUS_NOT_FOUND	Le contexte est introuvable.

Remarques

Si la fonction ajoutée figure déjà dans la liste, elle sera supprimée et insérée à la nouvelle position.

BCryptAddContextFunction peut être appelé uniquement en mode utilisateur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	bcrypt.h
Bibliothèque	Bcrypt.lib
DLL	Bcrypt.dll

Voir aussi

BCryptRemoveContextFunction

Partager via