Fonction CryptCATAdminAcquireContext2 (mscat.h)

  • Article

La fonction CryptCATAdminAcquireContext2 acquiert un handle dans un contexte d’administrateur de catalogue pour un algorithme de hachage et une stratégie de hachage donnés.

Vous pouvez utiliser ce handle dans les appels suivants aux fonctions suivantes :

Cette fonction n’a pas de bibliothèque d’importation associée. Vous devez utiliser les fonctions LoadLibrary et GetProcAddress pour établir un lien dynamique vers Wintrust.dll.

Syntaxe

BOOL CryptCATAdminAcquireContext2(
  [out]          HCATADMIN               *phCatAdmin,
  [in, optional] const GUID              *pgSubsystem,
  [in, optional] PCWSTR                  pwszHashAlgorithm,
  [in, optional] PCCERT_STRONG_SIGN_PARA pStrongHashPolicy,
                 DWORD                   dwFlags
);

Paramètres

[out] phCatAdmin

Pointeur vers le handle de contexte de l’administrateur du catalogue affecté par cette fonction. Une fois que vous avez terminé d’utiliser le handle, fermez-le en appelant la fonction CryptCATAdminReleaseContext .

[in, optional] pgSubsystem

Pointeur vers le GUID qui identifie le sous-système. DRIVER_ACTION_VERIFY représente le sous-système pour les composants du système d’exploitation et les pilotes tiers. Il s’agit du sous-système utilisé par la plupart des implémentations.

[in, optional] pwszHashAlgorithm

Chaîne Unicode terminée par null facultative qui spécifie le nom de l’algorithme de hachage à utiliser lors du calcul et de la vérification des hachages. Cette valeur peut être NULL. S’il est NULL, l’algorithme de hachage par défaut peut être choisi, en fonction de la valeur que vous avez définie pour le paramètre pStrongHashPolicy . L’algorithme par défaut dans Windows 8 est SHA1. La valeur par défaut peut changer dans les versions ultérieures de Windows. Pour plus d'informations, consultez la section Notes.

[in, optional] pStrongHashPolicy

Pointeur vers une structure de CERT_STRONG_SIGN_PARA qui contient les paramètres utilisés pour case activée pour les signatures fortes. La fonction choisit l’algorithme de hachage commun le plus bas qui satisfait à la stratégie spécifiée et à l’algorithme spécifié par le paramètre pwszHashAlgorithm ou l’algorithme système par défaut (si aucun algorithme n’est spécifié).

dwFlags

Réservé. Cette valeur doit être zéro.

Valeur retournée

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

Si la fonction échoue, la valeur de retour est zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Le tableau suivant répertorie les codes d’erreur les plus couramment retournés par la fonction GetLastError .

Code de retour Description
ERROR_INVALID_PARAMETER
 Le paramètre phCatAdmin ne peut pas être NULL.

Le paramètre dwFlags doit être égal à zéro (0).
ERROR_NOT_ENOUGH_MEMORY
 La mémoire était insuffisante pour créer un objet administrateur de catalogue.
NTE_BAD_ALGID
 L’algorithme de hachage spécifié par le paramètre pwszHashAlgorithm est introuvable.

Notes

Cette fonction vous permet de choisir, ou choisir pour vous, l’algorithme de hachage à utiliser dans les fonctions qui nécessitent le contexte administrateur du catalogue. Bien que vous puissiez définir le nom de l’algorithme de hachage, nous vous recommandons de laisser la fonction déterminer l’algorithme. Cela protège votre application contre les algorithmes de codage dur qui peuvent devenir non approuvés à l’avenir.

Spécifications

   
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mscat.h
Bibliothèque Wintrust.lib
DLL Wintrust.dll

Voir aussi

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog