Fonction CryptEnumOIDFunction (wincrypt.h)

Article
08/27/2023

La fonction CryptEnumOIDFunction énumère les fonctions d’identificateur d’objet (OID) inscrites. Les fonctions OID énumérées peuvent être filtrées pour inclure celles identifiées par leur type d’encodage, leur nom de fonction, leur OID ou toute combinaison de type d’encodage, nom de fonction et OID. Pour chaque fonction OID qui correspond aux critères de sélection, une fonction de rappel fournie par l’application, pfnEnumOIDFunc, est appelée.

Syntaxe

BOOL CryptEnumOIDFunction(
  [in] DWORD                   dwEncodingType,
  [in] LPCSTR                  pszFuncName,
  [in] LPCSTR                  pszOID,
  [in] DWORD                   dwFlags,
  [in] void                    *pvArg,
  [in] PFN_CRYPT_ENUM_OID_FUNC pfnEnumOIDFunc
);

Paramètres

[in] dwEncodingType

Spécifie le type d’encodage à mettre en correspondance. La définition de ce paramètre sur CRYPT_MATCH_ANY_ENCODING_TYPE correspond à n’importe quel type d’encodage. Notez que si CRYPT_MATCH_ANY_ENCODING_TYPE n’est pas spécifié, un type d’encodage de certificat ou de message est requis. Si le mot d’ordre inférieur qui contient le type d’encodage de certificat est différent de zéro, il est utilisé ; sinon, le mot d’ordre supérieur qui contient le type d’encodage de message est utilisé. Si les deux sont spécifiés, le type d’encodage de certificat dans le mot d’ordre inférieur est utilisé.

Les types d’encodage actuellement définis sont les suivants :

CRYPT_ASN_ENCODING
X509_ASN_ENCODING
PKCS_7_ASN_ENCODING
CRYPT_MATCH_ANY_ENCODING_TYPE

[in] pszFuncName

Nom d’une fonction pour laquelle une recherche de correspondance non sensible à la casse est effectuée. La définition de ce paramètre sur NULL entraîne la recherche d’une correspondance pour n’importe quel nom de fonction.

[in] pszOID

Si le mot d’ordre supérieur de pszOID est différent de zéro, pszOID spécifie l’identificateur d’objet pour lequel une recherche de correspondance non sensible à la casse est effectuée. Si le mot d’ordre supérieur de pszOID est égal à zéro, pszOID est utilisé pour faire correspondre un identificateur d’objet numérique. La définition de ce paramètre sur NULL correspond à n’importe quel identificateur d’objet. La définition de ce paramètre sur CRYPT_DEFAULT_OID limite l’énumération aux seules fonctions par défaut.

[in] dwFlags

Réservé pour une utilisation ultérieure et doit être égal à zéro.

[in] pvArg

Pointeur vers les arguments à passer à la fonction de rappel CRYPT_ENUM_OID_FUNCTION .

[in] pfnEnumOIDFunc

Pointeur vers la fonction de rappel exécutée pour chaque fonction OID qui correspond aux paramètres d’entrée. Pour plus d’informations, consultez CRYPT_ENUM_OID_FUNCTION.

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.

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

Partager via