Fonction CryptGetDefaultOIDFunctionAddress (wincrypt.h)

Article
08/27/2023

La fonction CryptGetDefaultOIDFunctionAddress charge la DLL qui contient une adresse de fonction par défaut. Il peut également retourner l’adresse de la première ou de la fonction OID ( Identificateur d’objet par défaut) installée dans un jeu de fonctions initialisé et charger la DLL qui contient l’adresse de cette fonction.

Syntaxe

BOOL CryptGetDefaultOIDFunctionAddress(
  [in]           HCRYPTOIDFUNCSET  hFuncSet,
  [in]           DWORD             dwEncodingType,
  [in, optional] LPCWSTR           pwszDll,
  [in]           DWORD             dwFlags,
  [out]          void              **ppvFuncAddr,
  [in, out]      HCRYPTOIDFUNCADDR *phFuncAddr
);

Paramètres

[in] hFuncSet

Handle de jeu de fonctions précédemment obtenu à partir d’un appel à CryptInitOIDFunctionSet.

[in] dwEncodingType

Type d’encodage à mettre en correspondance. Actuellement, seuls les X509_ASN_ENCODING et les PKCS_7_ASN_ENCODING sont utilisés ; toutefois, des types d’encodage supplémentaires peuvent être ajoutés à l’avenir. Pour faire correspondre les deux types d’encodage actuels, utilisez :

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

[in, optional] pwszDll

Nom de la DLL à charger. Normalement, le nom de la DLL est obtenu à partir de la liste retournée par CryptGetDefaultOIDDllList. Si pwszDll a la valeur NULL, une recherche est effectuée dans la liste des fonctions par défaut installées.

[in] dwFlags

Réservé à une utilisation future et doit être égal à zéro.

[out] ppvFuncAddr

Pointeur vers l’adresse de la fonction de retour. Si la fonction échoue, une valeur NULL est retournée dans ppvFuncAddr.

[in, out] phFuncAddr

Utilisé uniquement si pwszDll a la valeur NULL. Lors du premier appel à la fonction, *phFuncAddr doit avoir la valeur NULL pour acquérir la première fonction installée.

Lorsque cette fonction réussit, *phFuncAddr est défini sur un handle de fonction. Le nombre de références pour le handle de fonction est incrémenté.

Après le premier appel à la fonction, phFuncAddr est défini sur le pointeur retourné par l’appel précédent. Ce pointeur d’entrée est toujours libéré dans la fonction via un appel à CryptFreeOIDFunctionAddress par cette fonction. L’appel pour libérer le pointeur est toujours effectué même lorsque la fonction main retourne une erreur.

Un phFuncAddr non NULL doit être libéré via un appel à CryptFreeOIDFunctionAddress ou en étant renvoyé en tant qu’entrée à cette fonction ou en tant qu’entrée à CryptGetOIDFunctionAddress.

Si pwszDll n’a pas la valeur NULL, la valeur de ce paramètre est ignorée et un pointeur non NULL n’est pas libéré.

Valeur retournée

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

Si la fonction échoue, elle retourne zéro (FALSE).

Configuration requise

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

Voir aussi

Fonctions de prise en charge OID

Share via