BCryptConfigureContextFunction, fonction (bcrypt.h)

Article
02/26/2024

[BCryptConfigureContextFunction peut être utilisé 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 BCryptConfigureContextFunction définit les informations de configuration de la fonction de chiffrement d’un contexte CNG existant.

Syntaxe

NTSTATUS BCryptConfigureContextFunction(
  [in] ULONG                          dwTable,
  [in] LPCWSTR                        pszContext,
  [in] ULONG                          dwInterface,
  [in] LPCWSTR                        pszFunction,
  [in] PCRYPT_CONTEXT_FUNCTION_CONFIG pConfig
);

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 une utilisation.

[in] pszContext

Pointeur vers une chaîne Unicode terminée par null qui contient l’identificateur du contexte pour lequel définir les informations de configuration de la fonction de chiffrement.

[in] dwInterface

Identifie l’interface de chiffrement pour laquelle définir les informations de configuration de la fonction. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE	Définissez les informations de configuration de la fonction dans la liste des fonctions de chiffrement asymétrique.
BCRYPT_CIPHER_INTERFACE	Définissez les informations de configuration de la fonction dans la liste des fonctions de chiffrement.
BCRYPT_HASH_INTERFACE	Définissez les informations de configuration de la fonction dans la liste des fonctions de hachage.
BCRYPT_RNG_INTERFACE	Définissez les informations de configuration de la fonction dans la liste des fonctions de générateur de nombres aléatoires.
BCRYPT_SECRET_AGREEMENT_INTERFACE	Définissez les informations de configuration de fonction dans la liste des fonctions d’accord secret.
BCRYPT_SIGNATURE_INTERFACE	Définissez les informations de configuration de fonction dans la liste des fonctions de signature.
NCRYPT_KEY_STORAGE_INTERFACE	Définissez les informations de configuration de la fonction dans la liste des fonctions de stockage de clés.
NCRYPT_SCHANNEL_INTERFACE	Définissez les informations de configuration de fonction dans la liste des fonctions Schannel.
NCRYPT_SCHANNEL_SIGNATURE_INTERFACE	Définissez les informations de configuration de la fonction dans la liste des suites de signatures que Schannel accepte 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 pour laquelle définir les informations de configuration.

[in] pConfig

Adresse d’une structure de CRYPT_CONTEXT_FUNCTION_CONFIG qui contient les nouvelles informations de configuration de fonction.

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.

Remarques

BCryptConfigureContextFunction 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

CRYPT_CONTEXT_FUNCTION_CONFIG

Share via