Identificateurs de propriété primitive de chiffrement

Les valeurs suivantes sont utilisées avec les fonctions BCryptGetProperty et BCryptSetProperty pour identifier une propriété.

BCRYPT_ALGORITHM_NAME

L"AlgorithmName »

Chaîne Unicode terminée par null qui contient le nom de l’algorithme.

BCRYPT_AUTH_TAG_LENGTH

L"AuthTagLength »

Longueurs de balise d’authentification prises en charge par l’algorithme. Cette propriété est une structure BCRYPT_AUTH_TAG_LENGTHS_STRUCT . Cette propriété s’applique uniquement aux algorithmes.

BCRYPT_BLOCK_LENGTH

L"BlockLength »

Taille, en octets, d’un bloc de chiffrement pour l’algorithme. Cette propriété s’applique uniquement aux algorithmes de chiffrement de bloc. Ce type de données est un DWORD.

BCRYPT_BLOCK_SIZE_LIST

L"BlockSizeList »

Liste des longueurs de blocs prises en charge par un algorithme de chiffrement. Ce type de données est un tableau de DWORD. Le nombre d’éléments dans le tableau peut être déterminé en divisant le nombre d’octets récupérés par la taille d’un seul DWORD.

BCRYPT_CHAINING_MODE

L"ChainingMode »

Pointeur vers une chaîne Unicode terminée par null qui représente le mode de chaînage de l’algorithme de chiffrement. Cette propriété peut être définie sur un handle d’algorithme ou un handle de clé sur l’une des valeurs suivantes.

Identificateur Valeur Description
BCRYPT_CHAIN_MODE_CBC L"ChainingModeCBC »
Définit le mode de chaînage de l’algorithme sur le chaînage de blocs de chiffrement.
BCRYPT_CHAIN_MODE_CCM L"ChainingModeCCM »
Définit le mode de chaînage de l’algorithme pour qu’il soit associé au mode CBC-MAC (CCM). Windows Vista : Cette valeur est prise en charge à partir de Windows Vista avec SP1.

BCRYPT_CHAIN_MODE_CFB L"ChainingModeCFB »
Définit le mode de chaînage de l’algorithme sur le chiffrement des commentaires.
BCRYPT_CHAIN_MODE_ECB L"ChainingModeECB »
Définit le mode de chaînage de l’algorithme sur codebook électronique.
BCRYPT_CHAIN_MODE_GCM L"ChainingModeGCM »
Définit le mode de chaînage de l’algorithme sur Galois/mode compteur (GCM). Windows Vista : Cette valeur est prise en charge à partir de Windows Vista avec SP1.

BCRYPT_CHAIN_MODE_NA L"ChaînageModeN/A »
L’algorithme ne prend pas en charge le chaînage.

BCRYPT_DH_PARAMETERS

L"DHParameters »

Spécifie les paramètres à utiliser avec une clé Diffie-Hellman. Ce type de données est un pointeur vers une structure BCRYPT_DH_PARAMETER_HEADER . Cette propriété peut uniquement être définie et doit être définie pour la clé avant la fin de la clé.

BCRYPT_DSA_PARAMETERS

L"DSAParameters »

Spécifie les paramètres à utiliser avec une clé DSA. Cette propriété est une structure BCRYPT_DSA_PARAMETER_HEADER ou BCRYPT_DSA_PARAMETER_HEADER_V2 . Cette propriété peut uniquement être définie et doit être définie pour la clé avant la fin de la clé.

Windows 8 : à partir de Windows 8, cette propriété peut être une structure BCRYPT_DSA_PARAMETER_HEADER_V2. Utilisez cette structure si la taille de la clé dépasse 1 024 bits et est inférieure ou égale à 3 072 bits. Si la taille de clé est supérieure ou égale à 512, mais inférieure ou égale à 1 024 bits, utilisez la structure BCRYPT_DSA_PARAMETER_HEADER .

BCRYPT_EFFECTIVE_KEY_LENGTH

L"EffectiveKeyLength »

Taille, en bits, de la longueur effective d’une clé RC2. Ce type de données est un DWORD.

BCRYPT_HASH_BLOCK_LENGTH

L"HashBlockLength »

Taille, en octets, du bloc d’un hachage. Cette propriété s’applique uniquement aux algorithmes de hachage. Ce type de données est un DWORD.

BCRYPT_HASH_LENGTH

L"HashDigestLength »

Taille, en octets, de la valeur de hachage d’un fournisseur de hachage. Ce type de données est un DWORD.

BCRYPT_HASH_OID_LIST

L"HashOIDList »

Liste des identificateurs d’objet de hachage encodés en DER. Cette propriété est une structure BCRYPT_OID_LIST . Cette propriété peut uniquement être lue.

BCRYPT_INITIALIZATION_VECTOR

L"IV »

Contient le vecteur d’initialisation (IV) pour une clé. Cette propriété s’applique uniquement aux clés.

BCRYPT_KEY_LENGTH

L"KeyLength »

Taille, en bits, de la valeur de clé d’un fournisseur de clés symétriques. Ce type de données est un DWORD.

BCRYPT_KEY_LENGTHS

L"KeyLengths »

Longueurs de clé prises en charge par l’algorithme. Cette propriété est une structure BCRYPT_KEY_LENGTHS_STRUCT . Cette propriété s’applique uniquement aux algorithmes.

BCRYPT_KEY_OBJECT_LENGTH

L"KeyObjectLength »

Cette propriété n'est pas utilisée. La propriété BCRYPT_OBJECT_LENGTH est utilisée pour obtenir ces informations.

BCRYPT_KEY_STRENGTH

L"KeyStrength »

Nombre de bits dans la clé. Ce type de données est un DWORD. Cette propriété s’applique uniquement aux clés.

BCRYPT_MESSAGE_BLOCK_LENGTH

L"MessageBlockLength »

Cela peut être défini sur n’importe quel handle de clé pour lequel le mode de chaînage CFB est défini. Par défaut, cette propriété est définie sur 1 pour la BFC 8 bits. La définition de la taille de bloc en octets entraîne l’utilisation de la BFC à bloc complet. Pour les clés XTS, elle est utilisée pour définir la taille, en octets, de l’unité de données XTS (généralement 512 ou 4096).

BCRYPT_MULTI_OBJECT_LENGTH

L"MultiObjectLength »

Cette propriété retourne une BCRYPT_MULTI_OBJECT_LENGTH_STRUCT, qui contient les informations nécessaires pour calculer la taille d’une mémoire tampon d’objet. Cette propriété est uniquement prise en charge sur les versions de système d’exploitation qui prennent en charge la fonction BCryptCreateMultiHash .

BCRYPT_OBJECT_LENGTH

L"ObjectLength »

Taille, en octets, du sous-objet d’un fournisseur. Ce type de données est un DWORD. Actuellement, les fournisseurs d’algorithmes de hachage et de chiffrement symétrique utilisent des mémoires tampons allouées par l’appelant pour stocker leurs sous-objets. Par exemple, le fournisseur de hachage vous oblige à allouer de la mémoire pour l’objet de hachage obtenu avec la fonction BCryptCreateHash . Cette propriété fournit la taille de la mémoire tampon pour l’objet d’un fournisseur afin que vous puissiez allouer de la mémoire à l’objet créé par le fournisseur.

BCRYPT_PADDING_SCHEMES

L"PaddingSchemes »

Représente le schéma de remplissage du fournisseur d’algorithme RSA. Ce type de données est un DWORD. Il peut s’agir de l’une des valeurs suivantes.

Identificateur Valeur Description
BCRYPT_SUPPORTED_PAD_ROUTER 0x00000001 Le fournisseur prend en charge le remplissage ajouté par le routeur.
BCRYPT_SUPPORTED_PAD_PKCS1_ENC 0x00000002 Le fournisseur prend en charge le schéma de remplissage de chiffrement PKCS1.
BCRYPT_SUPPORTED_PAD_PKCS1_SIG 0x00000004 Le fournisseur prend en charge le schéma de remplissage de signature PKCS1.
BCRYPT_SUPPORTED_PAD_OAEP 0x00000008 Le fournisseur prend en charge le schéma de remplissage OAEP.
BCRYPT_SUPPORTED_PAD_PSS 0x00000010 Le fournisseur prend en charge le schéma de remplissage PSS.

BCRYPT_PROVIDER_HANDLE

L"ProviderHandle »

Handle du fournisseur CNG qui a créé l’objet passé dans le paramètre hObject . Ce type de données est un BCRYPT_ALG_HANDLE. Cette propriété ne peut être récupérée que . il ne peut pas être défini.

BCRYPT_SIGNATURE_LENGTH

L"SignatureLength »

Taille, en octets, de la longueur d’une signature pour une clé. Ce type de données est un DWORD. Cette propriété s’applique uniquement aux clés. Cette propriété ne peut être récupérée que . il ne peut pas être défini.

Spécifications

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]
En-tête
Bcrypt.h