Fonction CryptRegisterOIDInfo (wincrypt.h)
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.
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 |