Fonction CertGetValidUsages (wincrypt.h)

La fonction CertGetValidUsages retourne un tableau d’utilisations qui se compose de l’intersection des utilisations valides pour tous les certificats d’un tableau de certificats.

Syntaxe

BOOL CertGetValidUsages(
  [in]      DWORD          cCerts,
  [in]      PCCERT_CONTEXT *rghCerts,
  [out]     int            *cNumOIDs,
  [out]     LPSTR          *rghOIDs,
  [in, out] DWORD          *pcbOIDs
);

Paramètres

[in] cCerts

Nombre de certificats dans le tableau à vérifier.

[in] rghCerts

Tableau de certificats à vérifier pour une utilisation valide.

[out] cNumOIDs

Nombre d’utilisations valides trouvées comme intersection des utilisations valides de tous les certificats dans le tableau. Si tous les certificats sont valides pour toutes les utilisations, cNumOIDs est défini sur négatif (–1).

[out] rghOIDs

Tableau des identificateurs d’objets (OID) des utilisations valides qui sont partagées par tous les certificats dans le tableau rghCerts . Ce paramètre peut avoir la valeur NULL pour définir la taille de cette structure à des fins d’allocation de mémoire. Pour plus d’informations, consultez Récupération de données de longueur inconnue.

[in, out] pcbOIDs

Pointeur vers une valeur DWORD qui spécifie la taille, en octets, du tableau rghOIDs et les chaînes pointées vers. Lorsque la fonction retourne, la valeur DWORD contient le nombre d’octets nécessaires pour le tableau.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro. Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

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