Fonction CryptGetDefaultOIDDllList (wincrypt.h)

  • Article

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