Partager via


Fonction BCryptSetContextFunctionProperty (bcrypt.h)

La fonction BCryptSetContextFunctionProperty définit la valeur d’une propriété nommée pour une fonction de chiffrement dans un contexte CNG existant.

Syntaxe

NTSTATUS BCryptSetContextFunctionProperty(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] LPCWSTR pszProperty,
  [in] ULONG   cbValue,
  [in] PUCHAR  pbValue
);

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 dans lequel définir la propriété de fonction.

[in] dwInterface

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

Valeur Signification
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
La fonction existe dans la liste des fonctions de chiffrement asymétrique.
BCRYPT_CIPHER_INTERFACE
La fonction existe dans la liste des fonctions de chiffrement.
BCRYPT_HASH_INTERFACE
La fonction existe dans la liste des fonctions de hachage.
BCRYPT_RNG_INTERFACE
La fonction existe dans la liste des fonctions de générateur de nombres aléatoires.
BCRYPT_SECRET_AGREEMENT_INTERFACE
La fonction existe dans la liste des fonctions d’accord secret.
BCRYPT_SIGNATURE_INTERFACE
La fonction existe dans la liste des fonctions de signature.
NCRYPT_KEY_STORAGE_INTERFACE
La fonction existe dans la liste des fonctions de stockage clés.
NCRYPT_SCHANNEL_INTERFACE
La fonction existe dans la liste des fonctions Schannel.

[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 la propriété.

[in] pszProperty

Pointeur vers une chaîne Unicode terminée par null qui contient l’identificateur de la propriété à définir.

[in] cbValue

Contient la taille, en octets, de la mémoire tampon pbValue . Il s’agit du nombre exact d’octets qui seront stockés. Si la valeur de la propriété est une chaîne, vous devez ajouter la taille d’un caractère pour stocker également le caractère null de fin, si nécessaire.

[in] pbValue

Adresse d’une mémoire tampon qui contient la nouvelle valeur de propriété.

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_ACCESS_DENIED
L’appelant n’a pas accès en écriture aux propriétés de la fonction.
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 ou la fonction spécifié est introuvable.

Remarques

BCryptSetContextFunctionProperty 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