Fonction BCryptSetContextFunctionProperty (bcrypt.h)

Article
02/26/2024

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

Partager via