Fonction CryptRegisterOIDInfo (wincrypt.h)

Article
08/27/2023

La fonction CryptRegisterOIDInfo enregistre les informations OID spécifiées dans la structure CRYPT_OID_INFO , les persistant dans le Registre.

Crypt32.dll contient des informations prédéfinies pour les OID couramment connus. Cette fonction permet aux applications d’augmenter les informations OID prédéfinies. Lors du premier appel de CryptRegisterOIDInfo, les informations OID inscrites sont installées.

Lors du développement des tables à l’aide de CryptRegisterOIDInfo, les nouvelles entrées peuvent être placées avant ou après des entrées prédéfinies, contrôlées par dwFlags. L’emplacement des informations OID inscrites affecte le résultat de CryptFindOIDInfo , car les tables sont recherchées dans l’ordre. D’abord les entrées inscrites placées avant la vérification des entrées prédéfinies, puis les entrées prédéfinies sont vérifiées et enfin, les entrées inscrites placées après la vérification des entrées prédéfinies. La première correspondance trouvée est retournée. Une entrée nouvellement inscrite placée avant les entrées prédéfinies peut remplacer l’une des entrées prédéfinies.

Syntaxe

BOOL CryptRegisterOIDInfo(
  [in] PCCRYPT_OID_INFO pInfo,
  [in] DWORD            dwFlags
);

Paramètres

[in] pInfo

Pointeur vers une structure de CRYPT_OID_INFO avec les informations OID à inscrire. Spécifiez le groupe pour lequel les informations OID doivent être inscrites en définissant le membre dwGroupId de la structure.

Remarque

Lors de l’inscription d’informations OID pour les algorithmes de suite B implémentés avec l’API chiffrement : nouvelle génération (CNG), vous devez définir le membre Algid de la structure CRYPT_OID_INFO sur CALG_OID_INFO_CNG_ONLY (0xFFFFFFFF).

[in] dwFlags

Par défaut, les informations OID inscrites sont installées après les entrées OID de Crypt32.dll. Si CRYPT_INSTALL_OID_INFO_BEFORE_FLAG est défini, les nouvelles informations OID sont installées avant les entrées de Crypt32.dll.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro (TRUE).

Si la fonction échoue, la valeur de retour est zéro (FALSE).

Remarques

Une fois que vous avez terminé d’utiliser les informations OID, désinscrivez-les en appelant la fonction CryptUnregisterOIDInfo .

Configuration requise

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