Fonction CryptGetDefaultOIDDllList (wincrypt.h)

Article
08/27/2023

La fonction CryptGetDefaultOIDDllList acquiert la liste des noms des fichiers DLL qui contiennent des fonctions d’identificateur d’objet par défaut (OID) inscrites pour un jeu de fonctions et un type d’encodage spécifiés.

Syntaxe

BOOL CryptGetDefaultOIDDllList(
  [in]      HCRYPTOIDFUNCSET hFuncSet,
  [in]      DWORD            dwEncodingType,
  [out]     WCHAR            *pwszDllList,
  [in, out] DWORD            *pcchDllList
);

Paramètres

[in] hFuncSet

Handle de jeu de fonctions précédemment obtenu par un appel à CryptInitOIDFunctionSet.

[in] dwEncodingType

Spécifie le 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

Note Un type d’encodage de certificat ou de message est requis. X509_ASN_ENCODING est la valeur par défaut. Si ce type est indiqué, il est utilisé ; sinon, si le type PKCS7_ASN_ENCODING est indiqué, il est utilisé.

[out] pwszDllList

Pointeur vers une mémoire tampon pour recevoir la liste de zéro ou plusieurs noms de fichiers terminés par null. La liste retournée se termine par un caractère NULL de fin. Par exemple, une liste de deux noms peut être :

L"first.dll\0 » L"second.dll\0 » L"\0 »

Pour récupérer le nombre de caractères larges que la mémoire tampon doit contenir, ce paramètre peut être NULL. Pour plus d’informations, consultez Récupération de données de longueur inconnue.

[in, out] pcchDllList

Pointeur vers un DWORD qui spécifie la taille, en caractères larges, de la liste retournée vers laquelle pointe le paramètre pwszDllList . Lorsque la fonction retourne, la variable pointée par le paramètre pcchDllList contient le nombre de caractères larges stockés dans la mémoire tampon.

Note Lors du traitement des données retournées dans la mémoire tampon, les applications doivent utiliser la taille réelle des données retournées. La taille réelle peut être légèrement inférieure à la taille de la mémoire tampon spécifiée lors de l’entrée. Lors de l’entrée, les tailles de mémoire tampon sont généralement spécifiées suffisamment grandes pour garantir que les données de sortie les plus volumineuses possibles tiennent dans la mémoire tampon. En sortie, la variable pointée par ce paramètre est mise à jour pour refléter la taille réelle des données copiées dans la mémoire tampon.

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). Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Cette fonction contient les codes d’erreur suivants.

Code de retour	Description
ERROR_MORE_DATA	Si la mémoire tampon spécifiée par le paramètre pwszDllList n’est pas assez grande pour contenir les données retournées, la fonction définit le code ERROR_MORE_DATA et stocke la taille de mémoire tampon requise, en caractères larges, dans la variable pointée par pcchDllList.

Configuration requise


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 support OID

Partager via